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(57) Abstract: A framework enables data source 
components to be developed independently of data 
consumer components. A mediation layer, typically 
implemented as a group of APIs (application 
progtamniing interface), handles and defines the 
mediation and interface between the source and 
data componente. The framework, called XIS 
(extensible information system), is especially suited 
for development of information-handHng systems 
and applications. Data source components and data 
consumer components aie typically designed to 
communicate with each other via several interfaces. 
Domain, relationship, attribute/me tadata» and change 
event interfaces are defined within the mediation 
layer. Other interfaces may also be defined. Data 
source components that are written for non-XTS 
aware environments or frameworks may still be used 
with XIS by "wrapping" such source components 
with code to conform to the interface requirements. 
Java objects are examples of data source components. 
Data consQmer ootnponeDts thas are able to use or 
consume various source components regardless of 
the data types and the data source. Thus, once a data 
consumer component is developed within the XIS 
firamuework, any data source components within the 
XIS framework may be consumed by a data consumer 
component 
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EXTENSIBUE LNFORMAHON SYSTEM 

A portion of the disclosure of this patent document contains material, which is 
suhject to copyright protection. The copyright owner has no objection to the facsimile 
5 reproduction by anyone of the patent document or the patent disclosure, as it appears 
in the Patent and Trademark OfiBce patent file or records, but otherwise reserves all 
copyright rights whatsoever. 

This application claims priority of co-pending U.S. Provisional Patent 
10 Application Serial No. 60/242,041 entitled "Extensible Information System paS)" by 
Kadel et al., filed October 20, 2000. Priority of the filing date of October 20, 2000 
is hereby claimed, and the disclosure of said Provisional Patent Application is hereby 
incorporated by reference. 

15 BACKGROUND 

1. Field Of The Invention 

The present invention relates generally to data processing systems and, more 
20 particularly, to systems that process, analyze, and display data or information. 

2. Description of the Related Art 

The continuing inroads made by computer technology into the practices of 
25 infonnation storf^e and manipulation have qpraed up new realms of possibility for 
intelligent, informed dedsion-making. From labor statistics and scientific databases 
like the human genome project to traffic patterns and aircraft positions, the 
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availability of iofonnation in electronic form allows sophisticated analysis techniques 
and display methods to be applied at the touch of a button* However this diverse 
array of information also poses significant challenges in areas such as: 

effective organization of information; 
5 - ability to iaterpret and manipulate iofonnation in an increasingly 

wide variety of formats so that data and processing software can 

be brou^t together in a compatible but also timely and effective 

way; and 

recognizing and navigating relationships between disparate 

10 information types. 

This task of information management has already grown beyond the ability of 
human operators to keep pace with it, and in most applications, there is far more 
relevant information electronically available on the web and elsewhere than is 
effectively used. The problem is that software affording display of and interaction 

1 5 with information must be custom-designed for the particular type and format of the 
information it will work with. This leads to high costs of software development and 
limited availabilily of software appropriate to information of interest, and poor 
integration between information ftom different soinrces. An analyst mtist use one 
program whOT dealing with geographic distribution data such as precipitation amounts 

20 or land use, another for rendering 3-dimensional terrain, another for examining 

congressional districts and voting records, and so on. Many desirable applications of 
available data, such as determining correlations between political party and land use 
strategy in this case, fell between flie cracks left by specialized applications, and there 
is no easy way to allow them to interoperate. 

25 The primary means for allowing one application to operate on the results of 

another are the limited cut and paste facilities offered by many operating systems, 
which allow plain or formatted text or images to be moved between prograna. There 
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is no independent way to transfer structured data such as a table of numbers with 
particular column headings, a set of lists of items under specified categories, or even • 
something as simple as a single number with an associated unit of measurement 
From the discussion above, it should be apparent that there is a need for 
5 computer systems that have greater ability to develop, integrate, and interoperate with 
disparate sources of information, to more easily develop software applications, 
components, or objects, and to facilitate interoperation of data between software 
components- .The present invention fulfills this need. 

10 SUM^IARY OF THE INVENTION 

In accordance with the present invention, a framework for use with object 
oriented progranaming (OOP) systems provides a framework user with classes that 
comprise a mediation layer that defines an interface between data source components 

15 and data consumer components such that tibe configuration of the data source 

components can be ^ecified independently of the data consumer components. The 
mediation layer specifies data relationships of the data objects, domain methods for 
defining groins of class attributes, attribute metadata for defining groups of class 
attributes, and change event registration for detecting changes in data values. Thus, 

20 when extended, the mediation layer of the firamework can support runtime data 
manipulation between unrelated data source components and data consumer 
components. In fliis way, the fimiework provides an extensible information system. 
The framework will be referred to herein as "XIS", and is especially suited to assist in 
the development of mfonnation-handling systems or ^plications. 

25 Data source components that are configured for a non-XIS-aware 

progranuning environment or fimiework may still be used with XIS by "wrapping" 
such source components with code to conform to the interface requirements. Data 
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objects of the well-knowa "Java" progranuning language are examples of data source 
components. Data consumer components thus are able to use or consume various data 
source components regardless of the data types and the data source. Thus, once a data 
consumer component is developed within the XIS framework, any data source 

5 components witiiin the XIS framework may also accordingly be used. The 

framework can be provided as a group of APIs (application programming interface). 

The XIS framework of the present invention also includes libraries and APIs 
that provide information management technologies that enable developers and 
integrators to combine XlS-aware components, data sources, and off-the-shelf 

10 JavaBeans into complete systems designed around whatever architecture is best for 
the situation. XIS ftirther supports multiple, dynamic domains and is scalable to n-tier 
systems using the latest technology. The framework enables many developers to 
choose architectures based on their requirements (e.g., server, client/server, 
application server, web server, standalone, hand-held, etc.). 

15 Other features and advantages of the present invention should be apparent from 

the following description, which illxistrates, by way of example, flie principles of the 
invention. 



BIOEF DESCRIPTIONS OF THE FIGURES 

20 

Figure 1 is a diagram of the extensible information system (XIS) framework 
constructed in accordance with tihe present invention. 

Figure 2 is a more detailed diagram of Figure 1, showing the various interfaces 
witiiun XIS, constructed iii accordance with the present invention. 
25 Figure 3A is a mqre detailed diagram of Figure 1, including infomiatian and 

services available within XIS, constructed in accordance with the present inventioiL 
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Figure 3B is a hierarchical structure diagram of an embodiment of an 
InfoModel constructed in accordance with the present invention. 

Figure 4 is a more detailed diagram of Figure 1 showing various information 
available to components within XIS constructed in accordance with the present 
5 invention. 

Figure 5 is a diagram of the semantic representation of a data item within the 
XIS framework constructed in accordance with the present invention. 

Figures 6 A to 6F show data consumer components, particularly display 
components, constructed in accordance with the present invention. 
10 Figure 7 shows a consumer component displaying the properties exposed by a 

data source object constructed in accordance with the present invention. 

Figure 8 is amrified modeling language (UML) diagram of a Person object 

Figure 9 Usts a set of attributes exposed within the XIS framework by the 
Person object of Figure 6 constructed in accordance with the present invention. 
15 Figure 10 illustrates that an object constructed in accordance with the present 

invention may subscribe to more than one domain policy or definition. 

Figure 1 1 shows a domain usage and sequence scenario between a consumer 
component and source ccsnponent constructed in accordance with the present 
invention. 

20 Figures 12A to 12D list information regarding a Type Metadata package class 

typically implemented in the mediation layer and constructed in accordance with the 
present invention. 

Figure 13 shows a relationship usage scenario diagram between a consumer 
component and source component constructed in accordance with the present 
25 invention. 

Figure 14 is a flow chart that shows a reference resolution scenario usage 
sequence in which an indirect reference to an infiarmation element is created, passed 
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aroimd, and then resolved by two separate data consumers, causing reconstruction to 
occur only the first time. 

Figure 15 lists an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
5 Figures 16A to 16B list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figure 17 shows a data consumer component using a source component 
constracted in accordance with the present invention* 
10 Figures ISA to 18B list an exemplary Java sonrce file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 19A to 19B list an exemplary Java source file to implement an 
ioformation-handling application constructed in accordance wifli the present 
15 invention. 

Figure 20 shows a data consumer component using a source component 
constructed in accordance with the present invention. 

Figure 21 liste an exemplary Java source file to implement an information- 
handling application constructed in accordance with the present invention. 
20 Figures 22A to 22C list eia exemplary Java source file to implement an 

information-handling application constructed in accordance with the present 
invention. 

Figures 23 A to 23D list an exemplary Java source file to implement an 
information-handling application constructed hi accordance with the present . 
25 invention. 

Figures 24A and 24B show two data consumer components using a source 
component constructed in accordance with the present invention. 
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Figures 25 A to 25C list an exemplary Java source file to implement an 
iofonnatioii-handling application constructed in accordance with the present 
• invention. 

Figure 26 shows a data consumer component using a source componmt 
5 constructed in accordance with the present invention. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
witiiin the XIS framework constructed in accordance with the present invention. 

Figure 28 is a diagram of how InfoModels constructed in accordance with the 
present invention provide contextualization with the XIS framework. 
10 Figure 29 is a diagram of the pluggable service facilities within XIS 

constructed in accordance with the present invention. 

Figure 30 shows a flow diagram of a wizard or an API constructed in 
accordance with the present invention that assists in creating XML (extensible 
markcq> language) DSXs and database DSIs. 
15 Figure 31 shows objects and methods involved in distribution collaboration 

facilities constructed bx accordance with the present invention. 

Figure 32 shows semantic repositories for distributed agents constructed in 
accordance with the present invention. 

Figures 33 A to 33P list information regarding a ContentiEnfoBean class 
20 constructed in accordance with the present invention. 

Figures 34A to 34D list an information management package typically 
implemented in the mediation layer and constructed in accordance with the present 
invention. 

Figures 35A to 35F list an InfoMbdel interface package ^ically implemented 
25 in the mediation layer and constructed in accordance with the present invention. 
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Figures 36A to 36B list a package for handling change events typically 

implemented in the mediation layer and constracted in accordance with tiie present 

invention- 
Figures 36C and 36D show two sequence diagrams showing how change 
5 • events are handled and constructed in accordaoce with the present invention. 

Figures 37A to 37D list an exemplary Java source file to implement an 

information-handling application constructed in accordance with the present ' 

invention. 

Figures 3i8A, 38B, 38C, and 38D show two data consumer components using a 
10 source component constructed in accordance with the present invention. 

Figures 39A, 39B, and 39C is list information concerning an AttributeAlias 
class of the framework. 

Figure 40 is a block diagram of a computer device that may be used to operate 
with the fiumework, in accordance with the present invention. 

15 

DETAILED DESCRIPTION 

The following detailed description illustrates the invention by way of example, 
not by way of limitation of the principles of &e invention. This description will 

20 clearly enable one skilled in fiie art to make and use the uivention, and describes 
several embodiments, adaptations, variations, alternatives and uses of the inventioni, 
including what we presently believe is the best mode of carrying out the invention. 

The invention will be described by way of illustration with reference to various 
classes, objects, sample codes, etc. written within the exonuplary framework, but it 

25 should be imdexstood that such classes, class libiaries, application programming 
interfaces, interfeccs, objects, etc, may be diflFerently coded, implemented, designed, 
etc. and yet support the functions and features of the present invention. 
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Object-Oriented Technology 

Many application programs and APIs (application program interface) are 
developed using object-oriented (00) technology. Using 00 technology, a system is 
typically developed as a collection of interrelated cooperative objects that are 

5 instances of classes that typically include corresponding states and behaviors^ A class 
is a blueprint or template that defines the variables and the methods conimon to all 
objects fliat are instances of the class. An object maintains its state in one or more 
variables and implements its behavior with methods or fimctions. 

Object-oriented programming (OOP) techniques encapsulate, or bind together, 

10 data and the methods that operate on them. This encapsulation permits program 
development to more closely model real-world entities and breaks up program 
development efforts into smaller, more manageable pieces. Although OOP 
techniques have done much to improve program development efiSciency, such 
techniques stDl require a great degree of code generation on the part of developers, 

15 which discourages program reuse. 

Even with OOP techniques, specifying data sources and the way in which data 
will be retrieved or updated from the data sources are still typically hard-coded within 
the objects themselves. An object, for example, may be specified to display pricing 
data (for sample, a price display object) and would likely be hard-coded such that 

20 the data source is predefined. Thus, an object may be written to retrieve data from a 
source such as a relational database management system CRDBMS), a spreadsheet file 
such as a spreadsheet in the format of "EXCEL" spreadsheet application by Microsoft 
Cozporation. or the object may be written to an XML file. Nevertheless, in 
conventional systems, the price display object would be limited such that if a different 

25 source of data, for example, an XML file rather than an EXCEL file, has to be used, 
the object has to be modified to incorporate access to and manipulation of the XML 
file. Furthermore, if a different set of fields are retrieved, for example, latitude and 
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longitude (i.e., data fields unrelated to pricing information), a new object to display 
latitude and longitude may have to be written to display such information in tabular 
fonnat 

Table I below shows the data configuration of a typical object 



Table I 

State/Properties: Name, SSN, position, DOB, and . . , 
Behavior: RecordQ 

gefRecords(DateRange) 

promote 0 



For an application to be able to use this data object, the application would need 
prior knowledge of object properties (state) and behavior. The application would be 
tightly coupled with the class from which the object was instantiated. The meaning 
and intent of the data mi^t be found in the source code or by asking the original 
programmers (e.g*, SSN is social security number stored as string rather than a 
nxnneric type). 

Assuming the object was created by one application written independently of 
another, the object could not be intelligently exchanged between the first appKcation 
and the other with the expectation fliat the object would be processed unless the 
applications wwe tightly coupled. A way to have objects be used in various 
applications is thus higWy desirable to reduce programming time and resources. 

Common OOP languages iuolude "Java" from Sun Microsystems, Inc. of Palo 
Alto, California, USA, C-Hf, Simula, and Smalltalk. 
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Framework 

The concept of a framework is an important part of 00 programming 
technique. A framework is a specification of Ae classes and the relationships 
between classes such that the framework defines a class hierarchy that can be used 

5 over and over again, with overrides and extensions. In this way, an initial problem 
solution specified by a class hierarchy can be adapted and customized for new 
circumstances, simplifying program maintenance. In essence, a framework is a set of 
OOP classes that embodies a predetermined set of attributes and methods for 
providing a common group of behaviore. 

10 OOP frameworks have been developed in an effort to fiir&er reduce program 

development costs. An application program developer utilizes the framework and 
builds upon it, starting with the classes, attributes, and methods defined by the 
framework designs and adding subclasses and attributes and modifying methods 
depending on the problem to be solved. Such changes to the framework are typically 

15 referred to as framework extensions, and are made possible by the OOP notions of 
inheritance and polymorphism. Thus, a framework can speed flie development of an 
00 application program. The challenge confixmting framework developers, then, is 
to define a set of classes and methods that best supports the desired problem solution 
and will accept the most likely framework extensions. Thus, the designer of a 

20 framework must carefiilly assess what framework users will most likely need in the 
way of classes, attributes, and methods. 

It is therefore a technical advantage of the present invention to provide a 
framework feat allows informatian-handling software to adapt to new data types and 
formats of information, so that a single application built within this framework has a 

25 significantly broader range of compatibilities and domains of usefulness than a 

conventional application and, fiirfher, may automatically interoperate at a structured 
level wife ofeer similarly enhanced applications. In one embodiment of fee present 

11 
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invention, desirable applications of data such as detennining correlations between 
political party and land use strategy may be facilitated. 

In an embodiment of the present invention, a single information visualization 
or manipulation application is able to handle many diverse types of information, even 
5 those that are conceived and developed subsequently to the completion of 
development of the application itself. 

In another embodiment of the present invention, information from multiple and • 
diverse sources yet sharing some basic feature in common - such as being distributed 
in geographic space, or being distances measured in meters - can be simultaneously 
10 displayed (superimposed) and manipxilated within a single application. This invention - 
further provides means of access to common data sources such as relational databases, 
extensible markup language (XML) streams, and "Java** programming language 
software objects. 

In an embodiment of the present invention, an information-handling 
15 application is defined as any software application which is capable of utilizing 

digitally Waflable stmctmred information in bulk form, such as from electronic files, 
databases, or internet web sites to provide a display and/or a set of possible 
manipulations to a user, such as after some internal processing and transformation of 
the information such as summarizing it, performing computations on it, or selecting a 
20 subset Examples include but are not limited to graphing programs, analysis tools (for 
handling financial data, statistical, time series, etc.)> and interfaces to geographic 
information systems. Prototypical information-handling applications process 
stmctured information that has some form of hierarchical and/or modular structure. 
In one embodiment, XEnage and word processing applications are not examples of 
25 what we term infozmation-handling applications. In another embodiment of tiie 
present inventioti, stractured information in bulk form does not include plain text or 
specific electronic media files such as MP3 files. 

12 
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A conventional infonnation handling application such as a graphing program 
comprises two major components: one component handles the intake of infonnation, 
from storage devices, the network, or user input, and the other component handles the 
display of the information. There may also be parts of the application that perform 
5 computations or transformations on the information before it is displayed. From the 
developer's perspective, a modular piece of software that handles a portion of (or all 
of) the data intake function is a data somrce component, because it provides 
. information to other components within the application, A modular piece of software 
that handles part of (or all of) either the computation, transformation, or display of 

10 information is a data consumer component, because it uses (consumes) information 
provided by the data sources. 

Data sources and data consumers communicate with each other by making 
function calls. The particular functions and their parameters are defined as part of an 
internal version of an application program interface (API). The data consumer 

15 components handle data that is given them through specific calls on tiieir respective 
API, so that information provided througji data source components written for 
different applications will not be accepted. This situation provides little opportunity 
for reuse of data source or consumer components, since each is written to interoperate 
only with a specific instantiation of the other. 

20 In an embodiment of the present invention, an internal mediation layer is 

inserted between the data source components and the consumer components that 
expose data stmcture in a standardized way. Consiuner component are constructed 
to use tiiis common API, which is suitable for expressing an extremely wide variety of 
information types* Data source components can be constructed to deliver the 

25 information they take in this format, or a small amount of code can be written to 

translate the output of another source componsat into the common format The resuh 
of the construction is that any consiimer component can woik with any data source 
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component regardless of the specific nature of the information involved, or whether 
one was anticipated during the design of the other. The common API allows 
consumer components to automatically extract whatever features of information from 
a particular source they are most suitable for displajdng or computing with, and also 

5 allows them to utilize all the other features of that information in a generic, 
'Unspecialized fashion. 

Othar embodiments of the present invention comprise: (1) a system for 
representing infoimation such that: (a) a single fixed interface sufi&ces to describe a 
wide range of information types, (b) the information is rendered self describing to an 

10 extent, and (c) relationships between different information elements are expressed; (2) 
an apparatus for allowing this information representation to be employed as a medium 
between data source and data consumer software components; (3) a method and 
apparatus for attaching clarifying material on "intended use" to information so fliat 
consumer components can handle it more appropriately; (4) a method and apparatus 

15 for providing a context to all information consumption affording control over security 
and visibility of data; (5) a method and apparatus for allowing users to transfer 
information finom one consmner component to another through intuitive "drag and 
drop" and "cut and paste" int^aces; (6) a method and apparatus for developing 
enhanced information handling applications based on the foregoing fiameworic; (7) a 

20 method and ^Jparatus for automatically re-representing data from partially self 
describing source including relational databases, XML streams, and Java software 
objects; (8) a method and apparatus allowing end users using computers distributed 
over a network to collaboratively view and manipulate infonnation; and (9) a method 
and apparatus allowing software components distributed over a network to 

25 aut(Hnatically obtain annotations on intent and otiier aspects of encountered data. 

Most aspects of this invention can be implemented in any object oriented 
programming language such as Smalltalk, Objective C, C-H-, or Java. Certain aspects 
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of it, pointed out below, are especially suited to object oriented languages such as 
Java and Objective C that provide for run time self analysis by programs. However, 
these are in every case peripheral aspects, and the essential parts of the invention may 
be implemented in an object oriented language like C-H- without these capabilities. 
5 We will from time to time make reference to a "preferred embodiment" implemented 
in Java, but this should not be taken to be limiting. 

hi a preferred embodiment the present invention provides a system and/or 
framework of software conaponents for purposes of aiding development of 
. infonnatioia-handling appUcations. The system and/or framework of object-oriented 

10 software components aid the development of applications that read, gather, or receive 
electronic information and allow the display of such information to and manipulation 
by users. These applications are structured in a way so that there are distinct data 
. source components and data consumer components. The crucial features of the 
system and/or framework are the fact that data is seen by consumers only through a 

15 standard, conventionalized interface that incorporates: a breakdov^Ti into attributes, 
relationships, semantically-annotated "domain methods", event-broadcasting of 
changes in the foregoing to all registered consumers, metadata for each attribute 
providing certain declarative and procedural information including unit of measure, 
content length, data quality, default value, comparator function, summary function, 

20 validation function, and input/output fimctions for display and user editing within an 
extensible set of interface modalities, related data items available for each data item 
including those in child or generic relationships, and including the ability to store a 
reference without direct access to the related item itself (it can be reconstructed if 
needed), and contextualization such that the attributes, relationships, events, and 

25 methods available for a data item depends on context (see below). 

In a related embodiment, tiie system and/or framework includes methods for 
data exposure vi^erein Hie s^em determines automatically widch method is 

15 



wo 02/46916 



PCT/US03/48418 



employed in any particular case, and the choice is invisible to consumers. Exemplary 
methods such as, a data source component which directly provides the standard 
interface, a data source component which is accompanied by a separate Translator 
component which maps its interface to the standard interface; and a data source 
component which is automatically inspected by the system to determine what 
available data fields it has, these are exposed to consumers through the standard 
interface as detailed above. 

In a preferred embodiment, the contextualization provided by the system 
and/or fimnework is accomplished by delegating the jSnal responsibility for data 
exposure to an object termed an "hdfoModel" which is able to choose which of the 
available attributes and methods on an object should be e^iposed or hidden, and is able 
to add additional attributes or methods. • Preferably, the system and/or framework 
fiirfher provides facilities supporting transfer of data items between consumers, either 
by user manipulation (cut/paste or drag/drop) or by internal method calls. When a 
transf^ is initiated, the data item is passed without its contextual characteristics 
(siq>plied by an InfoModel) to the receiver. The system and/or framework includes 
facilities supporting the automatic integration of service components (generally 
comprismg management &cilities such as menu provision or running of user dialog 
routines and may or may not have data source provider and/or user interface provider 
components) into an application. Integration is handled by a plug*in manager object 
and set of interfaces such that: each service provider is given the opportunity xipon 
loading to query all components (data providers or consumers) existing within the 
application for whether they desire the service, and if so what parameters they would 
like to pass to it. The provider then acts on these rehouses. Whenever new client 
components are loaded, they will be queried and possibly resp(xided to by all services 
loaded within the application. 
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In another embodiment a system for importing partially schematized or 
structured data sources (such as a database system or an XML document) into a 
system as described herein. Any application written using the disclosed system 
and/or jEramework can then utilize these data sources through a standard interface. In 
5 particular, a system and/or firameworic for performing all or a substantial portion of 
the functionality outlined herein - if it is in connection with a framework or 
application implemented using a framework falling under categories as disclosed such 
as an ind&astmcture for mediating between information sources and consumers and 
rapidly assembling applications using them. 

10 Thus the present invention provides a method and apparatus involving two 

subsystems, one which processes the schema information for a data source to 
deteimine the ^e and metadata information for information attributes from &e 
source^ and one which processes ttie instance information. Preferably^ the schema . 
subsyst^ processes schematic information such as the type information contained in 

15 an XML schema document or the colimfm information available from a relational 
database management system and sets up appropriate metadata and relationship 
stmcture for information elements, but it does not necessarily create any information 
elements- Optionally, additional annotations can be provided by a user in tiie form of 
a file specifying how to map attributes in the original data to metadata, relationships, 

20 or domain policy attribute or method definitions. Preferably, the instance subsystem 
processes instance information such as that available fix)m an XML document or set 
of relational database rows, for which corresponding schema information can be 
found, and constructs information elements exposed throu^ the standard inter&ce. 
Data consumes can utilize the outputs of these as if they were custom-created data 

25 sources for the type of information described in the schemas. 

In a related aspect, inaplementation of the invention as described herein for 
both XML and relational databases is provided. In the XML implementation, a built- 
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in data type hierarchy for XML schemas is used to provide types to attributes, and the 
element-subelement-attribute structural hierarchy in XML schemas is used to 
determine relationships between information elements. All documents and schema 
references to other documents are followed up to their sources in order to specify 
jfiarfher attribute or relationship information. A user can optionally specify an XSLT 
(XML Stylesheet Transformations) document that maps the typed data fields found 
ftam the instance-schema combiimtion into attributes with richer metadata and/or 
references to specific domain policies. In the database implementation, the table 
cohmn heading types from the relational database (date, integer, text, etc,) are used to 
provide default type metadata to the attributes of information elements derived firom 
table rows of the database. A user can optionally specify a mapping between cohmms 
or sets of columns into attributes with specific metadata. Furthermore, a user can 
define a sequence of queries for which the results are to result in a hierarchy of 
information elements. For example, for each information element retrieved fix>m, for • 
example. Query I, a parameterized instantiation of Query 2 may be applied to retrieve 
elements which will be exposed as the children of the first information element. For 
each o£ these elements, a parameterized instantiation of Query 3 may be instantiated, 
and so focfh. 

Framework Block Diagram 

Figure 1 shows a basic block diagram of a framework that is implemented in 
accordance with the present invention. The framework 100 of Figure 1 can be used to 
develop, for example, an information-handling system or application wherein data 
source coihponents 102 and data consimier components 122 are separate and 
independent from each other but can communicate and share data. The framework 
100 described herein shall be called the extensible information system (XIS) 
framework* 
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From a developer's perspective, a modular piece of software tiiat handles part 
or aU of the data intake or retrieval function is a data source component 102. A 
modular piece of software that handles part or all of either data computation, 
transformation, presentation, or display of information is a data consumer component 
5 122. A conventional information-handling application such as a graphing program 
comprises tw^o major components: one side handles tibie intake of information from 
storage devices, the network, or user input, and the other side handles the display or 
presentation of the information. There may also be parts of the application that 
perform computations or transformations on the information before it is displayed. 

10 XIS Framework 

In the XIS ftamework 100 constructed in accordance with the invention, there 
may be more than one data source component 102 (also referred to as a source, data 
source, source component, and source object) and there may be more than one data 
consumer component 122 (also referred to as a consumer, consumer object, consumer 

15 component, and data consumer). The data source components 102 provide 

information to other components within the XIS framework 100 via a mediation layer 
1 12, while the data consiuner components 122 use the provided information. 

The source components 102 and consumer components 122 that comprise the 
XIS framework 100 are configured such that they communicate with eacb other in a 

20 manner that is supported by the progratmning environment in which the framework 
exists, typically by making fimction calls, via the mediation layer 1 12. In one 
embodiment, the mediation layer 112 consists of a group of application programming 
interfaces (APIs) or class libraries that define a common format for data exchange, 
establishing an information exchange standard. Thus, data source components 102 

25 coofigured for a different system, application, or framework may still be used within 
the XIS frameworic if they are "wrapped" in a predetermined way or are suitably 
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modified, as will be known to those skilled in the art, such that they conform to the 
requirements of the data exchange interface of the mediation layer 1 12. 

A relatively simple block of programming code may be produced to translate 
the output of a data source component 102 into flie common format as defined by the 
5 . mediation layer or API 112. In this way, any consumer component 122 may work 
with any data source component 102 regardless of the specific nature or type of 
information involved and regardless of whether the data soxm:e component was 
known or anticipated daring the design of the data consumer component Because of 
the XIS framework described herein, the data consumer 122 may also extract 

10 whatever features or sets of information that it needs or can process firom one or more 
data source, thereby enabling the data consume to utilize features and information in 
a generic unspecialized fashion. 

The mediation layer 112, which is between the data source components 1 02 
and the constuner components 122, exposes fhe data structure of the data source 

15 • components 102 in a manner that is common for the framework, preferably through 
: an API interface. Data consumer components 122 are constructed to use this common 
API, including utilizing the exposed data stracture^ The data consumer components 
122 are suitable for expressing an extremely wide variety of information types. In 
addition, the data consumers may be constructed to deliver the information received 

20 from the mediation layer to another data consumer component, or to output the 
information received for display. 

Data consumer objects 122 are application or software objects or components 
that use data, or may be said to consume it Examples of data consumers include 
display programs that display data in tabular format, in graphical mode, in 

25 ' organizational chart mode, spreadsheet mode^ timeline mode (similar to files in the 
format of the "PROJECT" application from Microsoft Corporation), and Hie like. 
Data consumers may be desktop based, web-based (Internet-based), distributed 
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architecture, intcipreted programs, and the like. Data coBSumer components within 
the XIS framework may provide display, computational, or interactive facilities. In 
tile present description, such specially configured data consumer components are 
referred to as "INFOBEAN" objecte, as available from the assignee of the present 
5 invention, Polexis, hic. of San Diego, California, USA. Those skilled in the art will 
• understand how to extend the framewoik 100 to produce desired applications, in view 
of the description herein. 

Figmre 2 shows additional details of the mediation layer 1 12 in the framework 
100. In the framework 100, four special types of interfaces may be exposed to the 

10 data consumer components 122. These four interfeces include Domain Definition or 
Domain Policy 202, Relationship 210, Attributes/Metadata 214, and Change Event 
216. in one embodiment, change events are registered within the XIS framework 100, 
These interfeces may be exposed, for example, through class and object libraries that 
may be developed for the XIS framework. With these pre-dejSned class and object 

15 libraries and APIs, developers of data .source components 102 and data consumer 
components 122 may independently develop their own source and consumer 
components, thus facilitating development of iofoimation-handling applications or 
systems. An example of a class that may be implemented or written in the mediation 
layer to facilitate development of source and consumer components is illustrated in 

20 Figures 33 A to 33P, which show details of a sari:q)le class called ContentlnfoBcan. 
Domain definitions or policies 202 (also referred to as domain objects or 
simply domains) are optional within the XIS firamework 100. If defined, the 
corresponding Domain methods 212 for such policies are exposed to the data 
consumers 122. Other information about the domain policy may also be exposed, 

25 such as Attributes/metadata 214 and Relationslqps 210 for that particular Domain 
Policy. Attributes/Metadata 214, Change Events 216, and Relationships 210 may also 
be exposed within the XIS firamework 100, even if domain policies are not defined. 
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Relationships show the relationship between data source components* 
Containment, hierarchies, and ad-hoc relationships, for example, may be shown. 
They may be expressed as "members of* and references. Relationships are thus 
recognized and may be obtained accordingly, as shown in Figure 14 described fiirther 
5 below. 

Change events may be used to ensure that all consumer or source components 
that have a^ interest in another soim;e components data are notified when changes 
occur. Changes may be notified when attributes, members (or containers), or 
references (or referrers) are added, updated, or removed and when values are changed. 

10 Once a data consumer component 122 obtains a reference to a data source 102, 

the data consumer comqponent may obtain access to these inter&ces 202, 210, 212, 
214, 216 through method calls in accordance with the programming environment of 
the host computer system. The data consumer 122 obtains such a reference typically 
in preparation to consume or use information from at least a particular data source 

15 102. Examples of such consumer component method calls include: 
get attributes; 

get member and container information elements; 
get referred and referring information elements; 
get unique ED and selection state; 
20 - add and remove instance specific attributes; 

register to be informed of changes to attributes or relationships; 
and 

mvoke mefliod calls of a semantically annotated type, described 
below. 

25 These types of method caUs will be familiar to those skilled in the art and femiliar 
with the progranuning environment of the host computer system. 
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Figure 3A is a schematic diagram showing the information about data source 
objects that is exposed by the mediation layer 112 in Figures 1 and 2, as well as the 
services available within Ihe XIS framework 100, In accordance with the invention, 
data source components are wrapped with an object that exposes the interface 
5 information for the data soiux^e to data consumers through the mediation layer. 

in the preferred embodiment^ the wrapper around each data source is an object 
provided by a class called InfoModeL As shown in Figure 3 A, a data source 
comprising a raw data item 35 1 , via the APIs 112 as desaibed above, offers a variety 
of information, as shown in Ihe blocks 354, 356, 358, 360, 362, toough which data 

10 consumers may gain access to the data somxie. The information represented by the 
blocks 354, 356, 358, 360, 362 is exposed or may be contained withra an InfoModel 
350, which provides an information space for all information available in the XIS 
framework 100 for the wrapped data source component. In one embodiment of the 
invention, the data needed by data consumers are accessed via such InfoModels (such 

15 as further illustrated iu Figure 28). The wrapper provided by the InfoModel is called 
a LeifDataltem object 352. Thus, tiiie InfoModel is an interface that permits data 
sooices and data consumers of the XIS framework to independently share their datau 
In this way, the methods 360, domains 358, metadata 354, relationships 356, and 
other information of a data source object are thus e^qposed using the InfoModel object, 

20 which may be said to exist in the mediation layer 1 12, which sets up contexts for data 
consumption. The XIS framework also provides additional data services through the 
mediation layer, such as the Plug-In Service 264 and BeanContext Service 266 
indicated in Figure 3 A. These services provide the functionality listed in their 
respective boxes 364, 366. Other data services may be provided, as desired. 

25 The InfoModel object provides a context for information access, i^e., context is 

instantiated through ihe InfoModel concept. In this way, security may be enforced, 
considering feat the conceptual or real "end-usef accessing the information is known 
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and thus tibie underlying data source may be forwarded correctly. Furtherraore, 
teough this InfoModel concept, an embodiment of the framework may be 
iirrplCTaented such that attributes and methods may be added or removed by the 
framework user. Original attributes and methods in one context may also be 
5 overridden. 

An attribute is any property of an object In one embodiment of the invention, 
• an attribute may be coded with an " AttributeDescriptor**, An AttributeDescriptor is 
provided by the object or its Translator to describe a property of the object using 
TypeMetaData, e.g., how to display it, how to edit it, its permitted ranges^ and the 

10 . like. Translators map data source-specific structures and types to an XlS-generic 
representation. Translators are further discussed below. Attributes may also be 
defined using Java introspection or reflection, as discussed ftirfher below. 

Dynamic attributes may also be e3q>osed within 4e XIS framework 100. 
These attributes are attributes that are exposed during run time, such as, for example, 

15 a database query wherein each column is an attribute revealed at run time. The 
mediation layer has a mechanism that captures such information. In the preferred 
embodiment, fte XIS framework operates in conjunction with a database management . 
application, so that the mediation layer utilizes run time database query mechanisms 
that generate metadata of the data object, such as data table column headings, data 

20 types, and the like. Such mechanisms may be provided, for example, by SQL queries 
and the like. In one embodiment data consumer applications using the XIS APIs are 
unaware of whether an attribute for a data item is obtained dynamically or statically, 
so that the process is transparent to ihe application user. 

A domain is a collection of semantically meaningfiil attributes and method 

25 signatures grouped by their ccmnnon domain of interest Exanq)les of domains 

include a Display Domain (a domain that describes how to display information) or a 
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Geo Domain (a domain that specijfies how to handle geographic information). 
Domains are further discussed below. 

The contextualization provided by the XIS ftamework system is accomplished 
by delegating the final responsibility for data exposure to an object termed an 
5 "InfoModcl", which is able to choose which of the available attributes and methods of 
an object should be exposed or hidden, and is able to add additional attributes or 
mefiiods. Preferably, the system and/or framework further provides facilities 
supporting tihe transfer of data items between data consinners, either by user 
manipulation (cut/paste or drag/drop) or by internal method calls. This supports data 

10 sharing among data consume. When a transfer is initiated, the data item is passed 
without its contextual characteristics (which are supplied by an InfoModel object) to 
tide receiver, i.e., only non-contextual information is transferred. In fliis way, the 
source data may remain unchanged. 

As illustrated in Figure 3A, a FieldMetaData file 354, a type of metadata, is 

15 used to represent sorting, subset, and visibility criteria for an attribute. This is forther 
explained below in conjunction wifh Examples 1 to 5, wherein subsets of data are 
shown depending on whether "All Attributes" or "Preferred Attributes" are shown. In 
one embodim^t of the invention, de&ult behavior method of domain policy attributes 
may also be overridden. Within this firamework, context-specific special attributes for 

20 flagging wheAer a data item should be visible or not (e.g., can be used for display 
filtOTng, including the XIS value slider, tree checkboxes in the map view, etc.) may 
be defined. This may be achieved through the mediation layer by utilizing a user 
interface to modify display processing for the data item- Furthermore, a selection 
attribute that is a context-specific special attribute for flagging whether an object is 

25 "selected" (and typically should be highlighted) may also be defined. Selected pieces 
of information are often shared among views (context-specific, though), and certain 
operations may be performed on the set of selected objects in a given context 
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The infoModel objects as described above know how to retuxa a data item (a 
LeifDataltem) given a corresponding raw data source identifier. The InfoModel also 
manages these data items. As indicated in Figure 3A, an InfoModel may contain one 
or more LeifDataltem objects, each of which provides an interface to a raw data item. 
5 An application developer may use an InfoModel object 350 to get a LeifDataltem 
object 352 in order to use the XIS APIs for accessing the underlying data source in a 
generic fashion. If two different data consumer components ask for a data item (e.g., 
• a LeifDataltem) from the same InfoModel for the same raw data source, then both 
data consumers will get the same instance of the LeifDataltem object. InfoModel 

10 objects may also be nested as indicated in Figure 3B. 

Information becomes normalized in the XIS framework so that any application 
can use an object's information by getting attributes and relationships dynamically at 
runtime. Therefore, instead of hard-coding a visualization program to a specific type 
of object, the visualization looks for the attributes it needs to perform its ftmction. 

15 Thus, the developer of the data consunaing module may obtain the information needed 
from the XIS LeifDataltem class, which wraps raw data item objects and exposes 
fhem to the data consumer through uniform APIs. The visualization can access all the 
information exposed, through the XIS APIs and techniques, as needed. If the data 
source provides AttributeDescriptor objects or translates the properties to domain 

20 attributes, then the information can be interpreted more intelligently in domain- 
specific ways. In one embodiment of the invention, the XIS framework also offers 
APIs and a programming model (or design pattern) that extends Sun's JavaBean 
pattem witii XIS information awareness. These extended JavaBeans comprise 
"smarter JavaBeans" that are provided in &e XIS framework as the specially 

25 configured INFOBEAN objects and, like JavaBeans, INFOBEANs can be visual or 
nonvisual components, and can be graphicdly combined in any standard Java 
development environment 
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InfoModel Class Objects 

In one embodiment, there are four types of InfoModels ia the XIS fiamework: 
BaselafoModei : ^ 

A single BaselnfoModel is required because it is responsible for creating and 
caching every BaseDataltem (data item) wrapping a Java object (the raw data item 
object). The BaselnfoModel object holds any object used as a LeifDataltem until the 
data item is no longer needed (i.e., until it is no longer strongly referenced).- 

SelectablelnfoModel : 
' A super class of BasehifoModel, this InfoModel delegates to any other 
InfoModel (^ically the BaselnfoModel), and creates SelectableDataltems (data 
items that are selectable). The SelectablelnfoModel objects add a selected Boolean 
attribute and delegate to the LeifDataltems from the prior InfoModel, Since the 
BaselnfoModel is a SelectablelnfoModel, all LeifDataltems have a selected attribute. 
This is true because any LeifDataltem is either in the BaselnfoModel itself; or is in an 
InfoModel that is nested in the BaselnfoModel and, therefore, inherits the selected 
attribute from the BaseDataltem. Additional SelectableLtifoModels can be 
instantiated to create ind^endent contexts for selection state, independent of otiier 
InfoModels. 

AttributeFactoiylnfoMbdel : 

This InfoModel allows AttributeFactoiy classes to be registered so that every 
time a LeifDataltem is created, it enables attribute fectories to add additional 
attributes to each LeifDataltem. 

InfoModelSubset 

- A super class of SelectablelnfoModel and AttributeFactorylnfoModel, this is 
the sinq)lest InfoModel. It delegates to its parent InfoModel and creates 
LeifDataltems that wrap ttiose XIS data items fiom flie other InfoModel, This 
InfoModel does not automatically add any attributes to the LeifDataltems it creates 
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and manages, but simply provides a context in which data items can be managed. 
Each InfoModel "layer" provides a context in which additional attributes can be 
defined, or existing ones can be overridden. Figures 34A to 34D list an exemplary 
Java package that lists various classes. Figures 35A to 35D list the InfoModel 
5 interface. An interface is a contract in the form of a collection of method and constant 
declarations. When a class implements an interface, it promises to implement all of 
the methods declared in tibiat interface. 
Exposing Data 

Figure 4 is a diagram showing how information from soxnce components may 

10 be exposed to data consumers using the mediation layer 1 12. The Attribute/Metadata 
interface 214 of Figure 2 exposes a data item 440, 442 as a set of attributes, each of 
which carry a value and a set of metadata that describes the value. A data consumer 
component 420, 422, 424 may obtain information &om one or more data items. 
Similarly, a data item 342 may be used by more than one data consumer 422, 424 via 

15 'the mediation layer or API 1 12. The information blocks 460, 461 show the 
information available to data consumers. 

A data source component 102 may comprise a data source interface (DSI) 
object 412, 414. A DSI object 412, 414 provides a conceptual way to encapsulate 
objects that provide data to the XIS framework 100. A class of a DSI object does not 

20 have to extend or implement any interface. Data is created (instantiated) in DSI 
objects to thereby encq>su1ate the data and make it available to other objects. The 
DSI itself may also be a data item that simply contains other data items (members). 
The data may be genemted internally or extracted finom an external source such as a 
database or across a IAN. In addition to creating the data, DSI objects are also 

25 responsible for maintaining and controlling data, such as removing and updating the 
data themselves if such changes are observed in &e underlying data used by the DSI 
to create the data. Property change events (216 of Figure 2) may be used by DSIs to 

28 



wo 02/46916 



PCTAJSOl/48418 



commrmicate changes observed in the original source data items to the listening data 
consumers. 

Any Java object may be a data source component. The Swing JButton, for 
example, is usually a transient object, and not typically retrieved in an information 
5 system. The Swing JButton, however, may still be a data source, if so d^red. 

INFOBEANs as stated above are data consumer components 420, 422, 424. 
They are specially configured objects that behave like JavaBeans that process and 
manipulate data in a generic fashion. They are also capable of intcxpreting and 
optionally displaying XIS data items. INFOBEANs use the XIS firamewoik API's to 
10 gain access to information about data items. 

As previously stated, any Java object may become a data item 440, 442 within 
the XIS jGramework 100. To make a data item out of JSlider (]avax.swingJSIider), it 
simply must be added to an INFOBEAN (data consumer component). Table n below 
provides programming code that makes a data item out of javaicswing. JSlider, thus 
15 exposmg the information blocks 460, 46 1 shown in Figure 4. 



Table n 

Jslider slider = new Jslider(0,100,50); 
tableIttfoBean.addRawDafcaItem(slider); 



The first line of code creates a data item out of JSlider. The second line of 
code adds the JSlider created in line 1 to the TablelnfoBean object (an INFOBEAN)* 
20 In this framework, JSlider knows nothing about the XIS framework, however, all its 
attributes are exposed, to be used and modified. 

There are basic steps that must be performed when creating a DSL First, 
before any code is actually written, a determination must be made as to how the 
original data or data source is to be obtained (e.g., will it come from a database, a flat 
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file, an EJB (Enterprise JavaBean), read from a socket, etc.). This step is perfonned 
prior to and independent of coding the DSL Once the data source has been 
determined, it must be decided what attributes of the data source should be exposed 
within the XLS framework. 

■ 5 The DSI component within the mediation layer of the XIS framework has the 

capability of exposing the attributes of a data soimce. In one embodiment, assuming 
that the data source is a Java object, the attributes to be exposed are determined 
through Java introspection. Introspection is a way to determine a bean's properties, 
methods, and events. Those skilled in the art will understand that a bean is a reusable 

10 software component, which may be combined to build applications. In this scenario, 
no additional code in the consumer component needs to be written. Although 
convenient, this approach is limiting, as it does not allow control over which attributes 
are exposed, and does not allow the user to deiSne custom visualization components or 
express semantics. Furfliermore, it requires the Java object to conform to the 

15 JavaBean design pattern. 

Another approach to determining which attributes of a data source should be 
exposed involves writing new code. This approach embeds XlS-aware code directly 
into the Java object. This aUows the component developer to directly specify details 
such as the attributes (e.g., via AttributeDescriptor) to be exposed along with their 

20 metadata, the Domains to which the DSI subscribes, which Domain methods are 
exposed with what implementations, and more. Writing new code enables greater 
control over the data item (as opposed to the introspection-only case) and provides 
more flexibility in dealing with any Java object rather than just JavaBean objects. 
One limitation of this approach is that the relationships between data items may not be 

25 diiecdy specified. 

Another ^roach for exposing attributes is to create a Translator class. An 
appUcation developex may place any of the XlS-aware code for e3q>osing attributes. 
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Domains, and the like in this class, as specifying relationships to other data as 
members or as references. This is described further below, in conjunction with the 
description of Figures 21 to 23, 

Referring back to Figure 4, a data consumer 420, 422, 424 may access a data 

5 source via a data source interfece (DSI) object defined in the mediation layer 1 12. 
Communication between the DSI objects 412, 414 and data consumers 420, 422, 424 
in the jframework 100 is mediated through a set of application programming interfaces 
(APIs) 1 12 that remain independent of the actual contents and types of the data 
sources. Such APIs are contained in class libraries. 

10 Using the framework 100, a data consumer 420, 422, 424 (for example, an 

INFOBEAN as shown in Figure 6B) may be able to use heterogeneous data sources 
and, thus, eliminate the need to write a particular display software object for each 
particular data source. Within this firamework, any data consumer object or 
appUcation may use the data source object's information by getting attributes and 

15 relationships dynamically at run time. Instead of hard coding a visualization to a 
specific type of data source component, the visualization object or data consumer 
looks for flie .attributes it needs to perform its function. Thus, in this firamework, 
developers for source and consumer objects work independently of each other. 
The DSI object may create any data structure containing members and 

20 references, and may expose any part of that data stmcture to the framewoik or system 
100 if it is desired Since there are no requirements involved to be a data somrce, a 
visualization bean can also be a data source. The data source can consume data from 
other data sources, and can create new data based on what it has learned For 
example, DSI objects n:iay be coded to use data source firom an RDBMS, e.g., systems 

25 such as provided by Oracle Corporation of Redwood Shores, California, USA and as 
provided by Microsoft Corporation of Redmond, Washington, USA through their 
"ACCESS'* application or SQL Server. DSI objects also may use data sources such as 
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XML format data, tabular data (e.g., spreadsheet data such as spreadsheet files in the 
format ofthe "Excel" application from Microsoft Corporation), emails schedules (e.g. 
schedule data in the format ofthe 'TROJECT** application from Microsoft 
Corporation), data following ihe SNMP (simple network management protocol), and 
5 theHke. 

Objects created by DSIs are considered to be raw objects in the XIS platform. 
These raw objects become normalized objects within the XIS framework when they 
conform to ihe mediation layer or the API 11 2. In one embodiment, when these raw 
objects are added to an XlS-enabled environment, the XIS framework wraps them 

10 with a normalized object called a LeifDataltem (see Figure 3 A) and holds the data 
item in one or more InfoModels. The raw data item could be a simple Java object 
(that does not know anything about XIS) or it can support XIS with direct references 
to AttributeDescriptors and other metadata that are recognized by XIS. Hie 
mediation layer is implemented in software and runs in-process. It is also exportable 

15 to serve as a distributed middleware if required by a given application. 

An atfaibute is any property of an object An attribute 474, 475 typically 
includes identity QD number) 476, 477, name ofthe attribute 478, 479, value 480, 
481, and the metadata type or Type Metadata 482, 484, and a description 484, 485. 
Attribute names 478, 479 may be the table cohnnn header or field name in an 

20 RDBMS. The description ofthe attribute 484, 485 may be plain text that explains the 
attribute. The value 480, 481 may be expressed as a number, string, or other basic 
data type, or may be expressed as a complex, structured object in itself. 

Referring back to Figure 2, the Attribute/Metadata interface 214 provides for 
fine-grained exposure of an information element or data item 440 442 (Figure 4); by 

25 "fine-grained" is meant that ihe data item is broken down into a nimiber of aspects or 
characteristics (the "attributes") which are simpler data elements. These might be 
numerical vahies, strings, arrays, or anything else that can be represented by a 
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software object (but is simpler than fhe original element). If a data consumer 412, 
414 is not able to handle the entire data element, it may be able to handle some of its 
attributes and therefore may be able to do something useful with it, unlike most 
systems providing interfaces for data integration, which require the entire interfece to 
5 be implemented to enable any data usage. 

The Attribute/Metadata interface 214 also makes each attribute self-Kiescribing, 
to a limited extent. In accordance with the invention, a data consumer designed 
withoutregard to a particular type of attribute is still able to display and perform 
limited operations with those attributes by using the metadata types. For example, a 

10 data consumer object or ENFOBEAN, which displays an X and Y chart of cost of 
living (expressed as a numerical value) versus geographical location (expressed as a 
territory or state character string, e.g., "California"), may be used to display a different 
set of data contained in another data source component or data item, so long as the 
metadata types of the different sets of data are compatible with the X and Y chart In 

15 particular, a data consumer component that renders and edits information may still be 
executed, the default value substituted in cases of absence, and statistical 
summarization performed, even if the data consumer component is processing a 
different data source com^nent Other operations are possible and additional 
metadata may be provided by developers for any identified classes of information 

20 elements (such as number, array, geographic entity, etc.) desired. Because of tins, 
data consumer developers naay identify the type of auxiliary information or 
procedures provided by the consumer component and then define the interface 
acccffding to which other developers creating data sources should provide or expose 
their metadata. 

25 In one embodiment, any property or attribute of an object may be defined with 

an AttributeDescriptor programming code. When a data source object is enabled 
within the XIS fi:amework, the computing system automatically creates 
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AttributeDescriptors for JavaBean properties and for some public properties. A 
JSlider object, for example, is a JavaBean, JavaBeaas have properties that are defined 
by the get<property> and set<property> methods. If the object is a JavaBean and 
provides a Beanlnfo, then it will be honored and treated according to the JavaBean's 
5 specification for Beanhifo classes. Only properties listed in the Beanlnfo appear as 
attributes. If metadata types, further discussed below, support the property's type, 
then they appear as attributes for that data item. Any properties that do not have 
TypeMetaData support become data items themselves (using the same reflection and 
introspection rules) and are listed in the data item's reference array, retrieved by the 

10 LeifDataltem getReferencesQ method (i.e., a method to obtain the references). 

Translators translate various data item classes, thereby enabling seamless integration 
of various data items without code modification. Translators may also be added to 
augment object reflection and introspection, i.e., by developers directly specifying the 
properties of an object 

15 Table III below lists exemplary programming code to define attributes. Table 

in shows liow to define a SIZE attribute. 



Table III 

public static AtlributeDescriptor SIZE; 
static { 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactoiy.getAttributeDescriptorFactoryO; 
SIZE = factoiy.createAttributeDescriptor( 
"size", Your.class, 

new NumericTypeMetaData("Size", long.class, 
UnitsOfMeasuTe.BYTES, 6)); 
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} 



Metadata are data or information regarding data, for example, data type, field 
name, length, value restriction, color, and the like. In practice, metadata are used to 
5 dejHne the structure and meaning of data objects in tools, databases, applications, and 
• other information processes. The data type metadata 482, 483 encompasses both 
procedural and declarative information, including (as appropriate for the value) but 
not limited to the foDowing: 

10 - unit of measure (from the provided unit of measure software 

object, converters to/from other units are accessible); 
content loigth; 

dejEault or maximum character length or precision of numbers; 
data quality (a rating given by the provider of the data); 
15 - defeult value (given by the provider of the data type); 

constraints (e.g., numeric range or list of acceptable values); 
formattmg; 

coinparator function (a procedure which takes two items of the 
data type in question and returns .whether one is to be ordered 

20 before, after, or tiie same as the other); 

validation function (returns 'true' or 'false' depending on whether 
the value for the attribute passes a certain test or set of tests, tests 
are developer-definable based on an interface which takes a 
software object providing a value and returns a Boolean value, 

25 but several reference implanentations are provided, such as one 

to determine whether a number is vdfhin a specified range; 
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list of ^jplicable smnmary (statistical) fimctioiis, summary 
functions are developer-definable based on an interface which 
takes a collection or array of software objects providing values 
and returns a single value (usually, but not necessarily of the 

5 same type) based on those values, several reference 

implementations are provided, including mean, standard 
deviation, count, max, min, median; and 
renderer and editor procedures for different output modalities 
(examples of modalities include local graphical window, HTML, 

10 plain text, and WML). 

A renderer displays a value, while an editor allows the user to enter or edit one; 
renderers and editors are both developer definable for any modality desired. In the 
preferred embodiment, renderers and editors for graphical windows, HTML, and plain . 

1 5 text are provided. 

In a simple example, a data item may have an attribute called "Manager" 
(attnT^ute name) 478, 479 that has a value of "John Doe," 480, 481 with metadata type 
482, 484 of content length (e.g. "30"), data type ("string"), and default value (""). In 
another example, a data item may have an attribute called "Cost" 478, 479 that has a 

20 value of "5.00" 480, 481 with metadata type of data type ("float"), default value 
("0.0"), summary statistics ("true"), validation function ("can never be less than 
zero"), and the like. 

The Attribute/Metadata interfiice specifies generic type accessors for object 
comparing, editing, formatting, rendering, and validation. This displaces the burden 

25 jtom the consumer of tiie data (INFOBEANs) to the developer of the TypeMetaData. 
It enables developers to use existing TypeMetaData to create content that is viewable 
in many forms such as a Swing Component, HTML table, and WML text 
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In one embodiment of the invention, the data consumer components are very 
generic, requiring little or no Domain-specific knowledge. For example, a data 
consumer object, for example, which resembles a spreadsheet, displays all available 
attributes of any data item, regardless of the Domain Policies represented. If useful to 
5 this consumer object, the metadata types may provide graphical control components 
for rendering attribute values. They also may supply editor components that give the 
end-user a standard way to modify an attribute, e.g., a color chooser GUI for selecting 
a new color value. 

An input/out metadata class, TypelO, defines the end content format. The 
10 TypelO class oflfers flexibility in both the iiiput (editmg) and output (rendering) of 
attributes according to their type. In one embodiment, a TypelO object is registered 
for a specific TypeMetaData using a registry, for example, the TypelORegistry. The 
registration is performed on the following interface types: HTMLTypelO, 
SwingTypelO, TextTypelO and WMLTypelO. Examples of Type 10 are "Swing 
15 Type 10" (for Java standard user interfece hT)rary called "Swing"), HTML (hypertext 
markup language), WML (wireless markup language), XML (extensible markup 
language), and text Swing is a graphical user interface (GUI) component kit, part of 
the Java Foundation Classes (JFC) that are integrated into the Java programming 
language. Swing simplifies deployment of applications by providing a complete set 
20 of user-interface elements written entirely in the Java programming language. Swing 
components permit a customizable look and feel without relying on any ^ecific 
windowing system. 

Table IV below is exemplary code to register two different TypelOs for the 
BooleanTypeMetaData. 



Table IV 

static { 
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TypeIORegis1iy.registerTypeIO(BooleanTypeMetaData.class, 

SwingTypelO.class, 

BooleanSwingTypelOxlass); 
TypeIORegistiy.registerTypeIO(BooleanTypeMetaData.class, 

TextTypelO.class, • 

BooleanTextTypelOxlass); 



In one embodiment, the metadata type may be oveiridden. For example, it is 
possible to override the editing/rendering capabilities of a TypeM In one 

5 embodiment, a new TypelO implementation is registered that provides the desired 
editing and rendering. If a developer only wants to affect the TypeMetaData instance 
that the developer is using, a subclass must be created and the TypelO registered with 
that subclass. Thereafter, any instances of the new subclass will use the specified 
TypelO. 

10 Other features may also be added to the TypeMetaData, such as summary 

• function, inin function, max function, and the like. For example, 
BooleanTypeMetaData adds summary methods for obtaining the total of false and 
true counts. Exemplary code to perform this modification is listed in Table V below. 



Table V 

static { 

TypeIORegistry.registerTypeIO(BooleanTypeMetaData.class, 
SwingTypelO.class, 
BooleanSwingTypelO.class); 
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TypeIORegistiy.TegisterTypeIO(BooleanTypeMetaDataxlass, 
TextTypelO.class, 
BooleanTextTypelO.class); 

} 

* Constructs a <b>BooIeanTypeMetaData<;/b> with <i>name</I> 

* @parani name the type name, returned by getNameQ. 

*/ 

public BooleanTypeMetaData(String name) { 
super(name); 

addSumniaryFunction(new FalseBooleanSunmiaryFunction(1his)); 
addSuimnaiyFunction(new TrueBooleanSuinmaryFunction(this)); 

} 



Methods may also be added to the TypeMetaData interface to provide standard 
behavior. Constraints may also be specified. Table VI below lists exemplary code to 
5 define a StringTypeMetaData called "Threat" with only three valid values 
("HOSTILE," "FRIEND," and 'TSfEUTRAL"). 

Table VI 

new StringTypeMetaData("Threat", 3) { 
{ 

setValidTest( 
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newDiscreteRangeO { 

{ 

addC'HOS"); 

add("FRI"); 

add("NEU"); 

} 

} 

); 

} 

} 



In one embodiment, an INFOBEAN data consmnCT The 
consumer examines the data item and its attributes, and may also access certain 

5 Domain attributes or execute Domain methods. If the consumer finds something it 
can use, the data item is further processed according to that consumer's function. For 
example, a user might drag a group of data items to an INFOBEAN that displays time 
relationships. The INFOBEAN would ignore those data items that did not have any 
appropriate time-related attributes. For those data items that have time-related 

10 attributes, the values can be obtained and used to populate a user interface. 

Referring back to Figure 2, the Domain Definition/Pohcy interface 202 
provides a means for the intended use of an attribute in a data item to be conveyed 
along witii the attribute itself. A domain policy typically comprises a list of attribute 
types with metadata and a list of function calls applicable to data possessing some or 

15 all of the attributes with parameter specifications, annotated with English text 
expressing the intent (i.e., description of the attribute). It is a group of related 
attributes (or properties), along with their semantics to usefully deal with data 
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Two or more modules (consumer and source) may subscribe to the same 
Domain. This, however, does not preclude the modules to be developed 
independently. A Domain Policy in one embodiment is defined by Java classes that 
declare a set of attributes and methods that might be supported by a given data item. 
5 For example, a temporal domain defines start time and duration as attributes. A 
timeline may only be properly plotted if such software object understands which 
attribute represents the start time and which attribute represents the duration or the 
end time. For this to work in XIS, two classes would need to exist: TemporalDomain 
and TemporalDomainWrapper. The TemporalDomain class defines the 

10 AttributeDescriptors (i.e., attributes) for each domain attribute; and the 

TemporalDomainWrapper class provides accessor and mutator (get and set) methods 
for these attributes. The wrapper also may declare one or more domain methods, 
which can have any signature to be invoked with the data item as the target object 
The wrapper is a convenience class for accessing domain attributes, providing 

15 optional default values, and invoking domain methods through Java reflection. 

Analyzing any domain yields a list of attributes and methods. Though much 
like a class definition in form, Domain Policies are supposed to convey and define 
logically independent characteristics related only by their domain context. It is very 
important not to fall into the trap of accidentally creating a domain that reflects a 

20 particular class or interface, or to add implementation-specific details that have 
nothing to do with conceptual domains into a given Domain Policy. An application 
can obtain and manipulate attributes of an object via a domain wrapper instead of 
accessing the object directly. This eliminates the dependency on the class of the 
object Ail application can now be written with only the knowledge of domains. No 

25 prior knowledge of a particular data source is required at development time, only 
domains. 
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In one embodiment, attribute aliases may be used. This enables one attribute 
to be substituted for another. This is typically used when two domains are defined 
that have similar attributes. This enables a consumer to ask for the Attribute from the 
domain that it knows about, and have the value translated from the Attribute of the 
DSI from the second domain. In one embodiment, the mediation layer implements 
fliis in a seamless operation, i.e., either the consumer or provider of the Attributes 
knows that it was an aliased Attribute, for example, "speed in knots" and "velocity in 
meters/sec". 

In another embodiment, methods of Domains may be registered with domain 
method descriptor factories similar to AttributeDescriptors. In this unplementation, it 
enables developers to reference domain methods via these static singletons, determine 
if domain methods of interest are defined, and to determine all infomiation about the 
argument types and inteipretation of the domain method. Furthermore, like the 
attribute descriptor factory (AttributeDescriptorFactory), developers pass the 
necessary ingredients or information to this factory, and the factory handles the 
internal registration of the method parameter types, retum type, exceptions, and 
interpretation. It ensures that one and only one object in &e Java runtime exists for 
each distinct domain method definition (each unique method signature), sintiilar to 
attributes and attributes factory. 

Figure 4 shows a schematic diagram of information that may be exposed by a 
data item 510 (440 and 452 in Figure 4). In an embodiment of the present invention, 
a data item 5 10 is defined as any unit of information that can be represented by a 
single object (perhaps containing subobjects) in an object oriented programming 
(OOP) language and is a coherent unit in terms of the semantics of the content domain 
that it relates to. Thus, data items are defined within a common semantic 
representation. Each information element is defined in terms of entities (data source 
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or data consumer component^ identity, relationships, attributes (name/value), services 
(not just data), and change events (dynamic nature). 

For example, a single row in a relational database containing information on a 
person's name and address constitutes an information element, but so would the table 
5 from which it comes, and even tiie entire database itself. Different levels or 

granularity of information is useful in the context of different applications, but any 
one of them can be considered an information element for purposes of our exposition. 
An example of a noncoherent unit would be a random collection of name/address 
rows from a database, tmless there was some comprehensible unifying characteristic 

10 to them (e.g., all rows for addresses in the state of Utah). 

Data items use Domain Policy attributes and methods to express the data item 
characteristics in a "normalized" manner. That is, a data item may expose Domain 
Policy methods 512, which are the functions or metiiods 516, 518, 520 of a particular • 
Domain Policy to characterize the data item's behavior and attributes to characterize 

15 the data item's information content A data item may also expose Domain attributes 
and metadata. A data item may also be part of more than one Domain Policy, thus a 
number of Domain methods 512 may be exposed with such data item 510. The 
Domain methods define the method name, possible input parameters, which may be 
mutable objects, i.e., input/output parameters, and optional retum value. This shows 

20 the expected behavior of the method, expectations of the inputs, and retum value 

constraints. The data item may also expose one or more attributes 530 and 538. Each 
attribute 530, 538 may have an attribute value 534, 542, an attribute descriptor 532, 
540 (containing, among other information, an English text description of the 
attribute), and type metadata 536, 543. The type metadata may include the class type 

25 544 (the class type of the attribute's value) and type input/output 546 (TypelO, for 10 
facilities). Examples of class type are LatLonAlt (for latitude, longitude, altitude 
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data), string (string data). Integer (integer data), Date (calendar date). Color, and the 
like. TypelO, as discussed above, may indicate the input and output format. 

The Relationships 522, e.g,, containment, hierarchies, and ad-hoc relationships, 
of a particular data item 510 may also be exposed as shown by the data items 524, 
526, 528. A data item may have zero (none at all) or may have many data' 
relationships to the other data items via Domain methods and attributes. 

Additional information exposed by a data element is a metadata override, 
which may be used to override a default behavior of a Domain Policy attribute. For 
example, default formatting of a date for some Domain Policy may be overridden, 
from MM-DD format (two digits for month and two digits for date) to "month text 
string" and DD format In one embodiment, flris may be implemented by assigning 
different metadata to an attribute using FieldMetaData witfiin the XIS fiamework. 

User Interface 

Figures 6A to 6F are exemplary representations of computer display windows 
produced by data consimaer components 122, which may be developed within the XIS 
ftamewoik 100. These data consumer components may use any data source 
component 102 for data and may also be run without an associated data source 
component. 

Figure 6A shows a computer display window called "Map View 1" produced 
by a mapping program for an INFOBEAN object that contains vector shoreline data 
from a data source component to produce the world shoreline depiction in the drawing 
figure. If an appropriate data source is loaded into this INFOBEAN, then appropriate 
additional pieces of information will be displayed, e.g., as geographic points on the 
depicted world map. Appropriate pieces of information for this INFOBEAN may 
inchide numeric data, which may, for example, be mapped to a set of latitude, 
longitude, and altitude coordinates on the map display of Figure 6A. 
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Figures 6B to 6D show window displays of a file manager or information 
exploring component, much like a file system explorer, called "XIS Explorer" with a 
vertically oriented directory firame on the left side of the window display and two 
stacked infonnatipn detail firames on the right side. The directory frame on the left 
5 may provide a tree diagram of available DSI components and their relationships to 
other components. Figure 6B shows that the Explorer View display does not contain 
any data (the "Explorer Contents" menu is empty). Figure 6C shows the XIS 
Explorer program after it is loaded with data called "Orders", "Computer", and 
"People Source" data sources, with "People Source" selected. Detail information 

10 about the People Source data is shown in the two stacked right jfeames. The upper 
right frame shows a listing of data objects or entries in the People Source data source, 
and the lower right frame shows attributes of a particular data object in People 
Source. A dififerent set of data objects or records is shown in Figure 6D, this time for 
the "Orders" data file. That is, Figure 6D corresponds to fee Figure 6B display after 
- 15 XIS Explorer is loaded with the "Orders" data. Thus, detail infoimation about the 

orders is shown in the two right frames. Figure 6D shows that a listing of data object 
names can be provided in the left tree diagram frame. As indicated by the display 
windows shown in Figures 6B to 6D, the same data consumer component or 
INFOBEAN-generated display format (Figure 6B) may be used to display different 

20 data source components (Figure 6C and Figure 6D, e.g., "People Source" and 
"Orders"). 

Figures 6E and 6F show a graphing program INFOBEAN display. Figure 6E 
shows the window display when it does not contain any data, while Figure 6F shows 
"Orders" (the same class of data objects shown in Figure 6D) loaded and displayed as 
25 a graph. This shows that the same data source component 102 may be utilized by 
more than one data consumer component to display different types of data 
characteristics and carry out different operations on the data, as shown in Figures 6B 
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through 6F. Thus, different DsfFOBEAN data consumer components can be 
configured to produce flie desired data operations and window displays from available 
data objects (sources). 

Figure 7 shows a computer wmdow display for an INFOBEAN data consumer 

5 component, showing the property sheet of a particular data source object called 
"Person." This "Person" object may be a Java object. Those skilled in the art will 
imderstand that JavaBeans are a specification developed by Sim Microsystems that 
defines how Java objects can interact An object that conforms to this specification is 
called a JavaBean. This object may be used by any application that understands the 

10 JavaBeans fomiat For example, the "INFOBEAN" objects available fi-om Polexis, 
Inc. of San Diego, California, USA are objects that behave as JavaBeans that can 
process data in a generic fashion, looking for and manipulating data pertaining to 
particular domains as generated by DSIs or otihier INFOBEANs. 

Data consumer objects may also be Java objects that present and/or process 2D 

15 and 3D maps, table/spreadsheet data, hierarchies (trees), plots (bar, scatter, pie, etc.), 
gantt/timeline, content (e.g., email), organization charts, caleiidars, properties or 
attributes, and the like. 

Figure 8 shows a unified modeling language (UML) class diagram for a Person 
class source data. Using the XIS firamework of the present invention, the data 

20 consumer, an INFOBEAN, obtains information, particularly, the attributes listed in 
Figure 7 (e.g., SSN, Display Name, DOB, and Name) of the Person object This set 
of information is shown in blocks 460 and 461 in Figure 4. This is perfomied, for 
example, by using a naming convention for methods, i.e., GET + "Attribute Name." 
An API determines the available methods of an object and determines attributes based 

25 on method names. For example, an API from "getDOB," "getName," and "getSSN" 
methods detemiines the attributes DOB, Name, and SSN, respectively. Java 
introspection may also be used 
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Figure 9 shows the different attributes obtained or exposed for the Person 
object (i.e., DOB, SSN, and Name). In addition, using the toStringQ method, 
available for every object in Java, as shown in Figure 6, the DisplayName attribute is 
also exposed. 

5 In one embodiment, no Translator exists for liie Person object. Also, there are 

no static get<PropertyName>Descriptor methods defmed, so the only XIS Domain 
Attribute is the displayName that is obtained, by defiiult, from the toStringQ method 
available in every object in Java. The remaming attributes (date of birth. Social 
Security number, and name), though not mapped to a Domain, are available through 

10 the mediation layer API. 

If an XIS Translator were used or if the Person class specified XIS 
AttributeDescriptors, then the Java fields could be mapped to domains. In this case, 
for example, the birth date and Social Security nimiber could be mapped to 
corresponding attributes in the "Personnel Domain". Within this domain, the 

15 attributes would be specified with detailed TypeMetaData, which is made available so 
that the data from the attributes, such as the Social Security number, can be 
appropriately validated, displayed, edited, formatted, and otherwise processed 
wherever that attribute is xise A 

Figure 10 shows how an object, particularly a data source component, may 

20 belong to multiple domain policies. In this case, for example, the domain policies 
include the Geo Domain (geographical domain). Movement Domain, and Display 
Domain. The Geo Domain has dejSned at least two methods called GetLatLonAlt and 
SetLatLonAlt The GetLatLonAlt method obtains the latitude, longitude, and altitude, 
while the SetLatLonAlt method sets these parameters. The Movement Domain 

25 contains a GetCourse method, which obtains the course or direction of an airplane, for 
example. The Display Domain has two methods called GetDisplayName and 
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GetBrushColor, which obtaia the name of the object and display the color of the 
object, respectively. 

Figure 1 1 shows a sequence diagram of a domain policy usage scenario. In 
this time sequence diagram, each column represents an entity (i.e., user display 1 102, 
5 data consumer component 1 1 04, and data source comtponent 1 1 06), and time or 
sequence flows from top to bottom* Here, a data consumer software component 
(middle) requests a data source to tell it the Domain Policies to which the data source 
subscribes. Upon receipt of the information, the data consumer checks to see whether 
these include the Geo, Movement, and Temporal Domains, which it recognizes. The 

10 developer of the data consumer need not have known about this particular source, nor 
the data source developer known about the particular consumer, for these two 
components to interoperate correctly: the data consumer plots three numbers given to 
it by the source as position, speed, and a time duration (computed by a call to a known 
function on the source), as Aey were intended by the source's developer. In the XIS 

15 framework, applications and components that comply with the Domain Policy API are 
able to share data in a simple yet powerful manner, ensuring automated integration 
and reuse. Thus, data sources and data consumers may be independently developed. 

In one embodiment, attributes of a given domain are exposed through the static 
final AttributeDescriptors of fliat domain* The AttributeDescriptors that make up any 

20 given domain are built using the AttributeDescriptorFactory. If the developer of a 
data item class uses a custom AttributeDescriptor, then it should be built (typically in 
the Translator) using this factory. 

Table VH below shows exemplary code that illustrates how a DisplayDomain 
builds its font attribute. 



Table Vn 
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public static final AttributeDescriptor font; 
static { 

AttributeDescriptor tmpFont = null; 
try{ 

AttributeDescriptorFactory factory = 

AttributeDescriptorFactory.getAttributeDescriptorFactoryO; 
tmpFont = factory,createAttributeDescriptor( 
"font", 

DisplayDomain.class, 

new com.xis.types.FontTypeMetaData('Tont") 

); 

} catch (Throwable t) { 
t.printStackTraceO; 

} 

font = tmpFont; 

} 



Providing the font parameter to 4e factory means that the expected method 
names for accessing the attribute will be getFontQ and setFontQ. The exception is 
5 thrown if the attribute has akeady been registered with that domain. The primary 
integral ingredient of an AttributeDescriptor is the appropriate TypeMetaData. 

Figures 12A to 12D list an exemplary Java package called com.xis.types and 
its respective classes. In one embodiment of the invention, several packages 
containing various classes to implement the features of the present invention are 
10 contained in class Ubraries or APIs. 
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Referring again to Figures 2 and 4, the set of Relationships 210, 472, 473 that a 
given data item 440, 442 possesses with other data items is also exposed through 
standard method calls. One method retrieves the "member elements" belonging to a 
given element in a parent-child relationship. These members are directly referred to 
5 by means of conventional object "pointers". 

Figure 13 is a block diagram representation of how relationships between data 
items wilhin the XIS ftamework 100 are exposed in a generic feshion. Member-of 
(i.e., hierarchical) and reference relationships are supported 

Members enable the creation of a hierarchical data structure. A data source 

10 object may also have members themselves. When members are added or removed, it 
is the data source's responsibility to fire the appropriate events to inform any listeners 
that the data structure has changed. By nature, certain objects have members (like • 
Collections or arrays). In one embodiment, the actual array is returned to the object 
requesting the relationship. 

15 A reference represents a pointer or a reference to an object. In one 

embodiment, an object may be referred to without instantiating that object until 
necessary. References in the XIS framework may also provide persistable or 
persistent data to define a link and may also refer to software classes/objects on how 
to later resolve such link to an actual live data item. These references may also 

20 provide aimotatioiis (e.g., description ofUnks and their roles with respect to data 
items). 

Figure 14 shows how references may be resolved. Information regarding 
relationships, as stated above, may be obtained using object pointers, e.g., there is an 
object pointer from one data item to another data item to indicate a parent-child 
25 relationship. In tins way, data source components may be able to determine which 
data items are directly or indirectly children of which others and the general 
relationships between data items. This set of relationship information may be used in 
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displaying and rq)resenting the data items with its own characteristic fashion. This 
relationship information, for example, may be helpful in an organization chart or an 
explorer-type consumer component Relationships, for example, may be a "peer-to- 
peer" or "members of* type. 

In Figure 13, for example, a data consumer Component A 1320 requests the 
relationship of a data source conqwnent 13 13 (Source 1), via the mediation layer 1 12 
shown in Figure 1. Via the same mediation layer 1 12, the data source component 
(Source 1) 1313 returns a data item, which indicates the relationship of the data 
source component or data item, as shown in Source 1 1315. Similarly, the same data 
consumer Component A 1320 may request the relationship of data source component 
1330 (Source 2), and such relationship information is returned 1325. Another data 
consumer Component B 1340 may also obtain the relationship infonnation of the data 
source (Source 2) 1330, i.e., the result 1335. As shown, the resulting relationship 
infonnation 1325 and 1335, e.g., how the relationship is represmted may depend on 
the data source component, for example, the relationship information shown in the 
box 1325 is different fix)m the box 1335. 

In one embodiment of the invention, a unique ID for a data item is available in 
the current runtime environment. Such imique ID for a particular item need not be 
recreated (or a new unique ID created) except when the data has been completely 
unloaded and then reloaded, e.g., loading of a row from a database, unloading it, and 
then reloading (will usually result in a new unique ID). 

A second method retrieves links representing a more general and indirect form 
of relationship comprising a text annotation and a reference object which can be used 
to either obtain the referred data item (or information element) or retrieve or 
reconstruct it if it is not directly available. This retrieval or reconstruction need not 
take place until the moment the referred information or data element is actually 
needed. In particular, the reference refers directly to a "resolver" object on which- 
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when retrieval is actually requested-a method is called with arguments also specified 
in flie reference. This method then retains the desired information element or data 
element. 

This mechanism is quite general; one possible implementation would be a 
5 resolver object able to make queries on a database and construct data source objects 
from the result The reference could specify the particular query to be made, with the 
effect ihsLt a very small reference (comprised primarily of a query string, assuming the 
resolver class is loaded as part of the general mechanisms within the application) can 
be passed around between application components and only resolved into a large, 

10 memory intensive data object when some operation (such as display to a user) needs 
to be performed on it. Other types of reference retrieval mechanisms not involving 
databases are possible, such as query of network based services or collection of direct 
user input, i.e., anythiug that can be implemented within the implementation language 
can be used as a reconstruction procedure. 

15 Additional methods on a data element may be implemented to provide 

Relationship information in the reverse direction ,that is, to the elements that contain a 
given element and elements that refer to a given element may also be acquired 
through direct queries. 

Finally, a more dynamic form of information is accessible through a 

20 standardized mechanism by which interested data consumers 122 or sources 102 can 
register— through calling a particular method on &e data source object 102-to receive 
events whenever one or more chosen aspects of a data source change. In particular, a 
data source maintains lists of those software objects interested in hearing about 
changes in attribute values, the addition or removal of attributes, the addition or 

25 removal of members or containers, and the addition and removal of references or 
referrers, and whenever one of these aspects changes, it sends a message to each 
object on the appropriate list This mechanism, founded on the event passing 
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mechanisms found in many object oriented programming languages and libraries but 
centered around information structure as exposed generically within the XIS 
framework, enables different components of an application to 'Tceep in sync" with 
information sources that change or grow during xise. In other words, if a data source 
5 signals a change in an information element, all displays and computations can be 
updated inunediately to reflect the change, much like a dynamically adjusting 
spreadsheet program. 

Figure 14 is an exemplary flow diagram that shows how a reference is resolved 
within an XIS framework. In the first block 1410, a data consumer component 

10 Consumer A produces or creates a reference to a data item Data X. In the next 
operation 1420, this reference is saved to disk, e.g., as a text file. In the next 
operation 1430, the data consumer component Consumer A is restarted and the 
reference is retrieved from the file saved in.the previous operation. In the next 
operation 1440, such reference is also passed to data consumers Consumer B and 

15 Consumer C. Next, at 1450, Consumer B requests resolution of ttie reference. This 
resolution is done in the next operation 1460, wherein Data X is constructed through 
executing a database query. This database query is stored as part of the reference 
mformation stored in the disk (block 1420). The query returns the data item Data X, ' 
which is then used by Consumer B (block 1470), Consumer C may also request 

20 resolution of the reference (block 1480). Considamg that data item X has been 
resolved by the data consumer component Consumer B, Data X is not reconstructed 
again .from the database, rather a cached version is directly returned instead (block 
1490). This operation 1490 assumes that no change in Data X occuixeA 
In one embodiment of the invention, the XIS firamework models 

25 commumcation after the JavaBeans PropertyChange mechaiiism. Figures 36A to 36B 
show a listing of an exemplary package, com.xis.leif.event, which includes interfiices, 
event objects, and default implementation adapters for events in the XIS framework. 
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The UML sequence diagram shown in Figure 36C shows how a data source 
interacts with an INFOBEAN. In particular, it shows how a data source and an 
INFOBEAN interact when data is added The INFOBEAN gets a LeifDataltem for 
that object and adds a listener. When the data source updates the object, or if any 
other INFOBEAN updates Ihe LeifDataltem, the LeifDataltem fires events to all 
listeners. 

Each INFOBEAN may choose to listen for changes in the data it is using. If it 
would like to receive updates, it must attach a LeifDataltemListener to each data item 
to which it would like to listen. Thus, when something changes in the data, the 
listener receives the event Upon receiving this event, the listener updates the 
corresponding data item if the change is one that concerns the INFOBEAN. 

Figure 36D shows a UML sequence illustrating how a data source and 
INFOBEAN interact particularly when data are updated. 

In one embodiment, state attributes are defined to assist in detennining change 
events as well as management of references. The state attribute describes what state 
the data is in at any time. This may be implemented to determine whether a data item 
should be kept and whether to display it, for example, without hstening to the parent 
of the data, if there is one. Exemplary states are defined below: 

(1) Deleted: When a raw data item is in this state, it is no longer 
being used and should be discarded. 

(2) Exists: When a taw data item is in this state, the data exists and 
is still being referenced as either a member of another raw data 
item or it is a DSI itself. 

(3) Live: This state mcludes everything in the Exists state. This 
state also means that the data item is also connected to a live data 
feed such as a database or server and that the connection is still 
alive. 
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(4) Dead: This state includes everything in the Exists state. This 

state also means that the data item was, at one point, connected to 
a live data feed, but the connection to the data feed no longer 
exists. An example of a Dead state is when the connection to a 
5 data server goes down and die data still exists in the DSI, but can 

no longer be updated 
To bett^ help imderstand the features of the invention, sample information- 
handling applications, using Java programmiag, are exemplified and discussed below. 
Example 1 

10 Figures 15 and 16 show two Java source files to implement an application 

within the XIS firamework. The ou^ut is shown in Figm^ 17. 

Figure 15 lists the HelloWorldjava source file that creates a HelloWorld 
object, which is a data source component This source file is a minimal Java object 
that satisfies the method conventions for a JavaBean, in &is case, it contains "get" and 
15 "set" methods (which often but need not necessarily correspond to private member 
variables), and a toStringQ method. 

Figures 16A and 16B list the TestHamess.java source file that creates a 
TestHamess object, which is a data consumer component. TestHamess contains all 
die code to access all the information exposed within XIS and display its 
20 properties/attributes using a PropertySheetlnfoBcan. The PropertySheeflnfoBean is a 
data consumer component, which displays the attributes of a data source component 

Referring back to Figure 16A, as shown in the portion of code 1602, many 
standard classes of the Java language are used. In addition, a set of classes provided 
within the XIS firamework, particularly within the mediation layer, is also used, e.g., 
25 com.xis.leif.inxBaseInfoModel. The code for the class Uhrary for the com.xis.leif 
class is not shown herein. Various alternatives relating to what classes are needed 
would depend on how the XIS firaaework of the present invention is implemented. 
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designed, and the like, as will be known to those skilled in the art in view of this 
description. 

The first line in mainQ of the HellbWorldjava code 1604 prevents the XIS 
PluglnManager firom starting up. The PlugTnManager is used for tying components of 
5 a large XIS application together based on resource files it finds associated with their 
classes. The PluglnManager is further discussed below. This feature is set to "off" to 
reduce the time to startup. * 

The lines of code shown 1606 in the first part of this source file sets up a 
predefined XIS InfoBean, in this case, PropertySheetMoBean that is capable of • 
10 displaying the available attributes of an object The attributes are obtained through 
the Java language reflection method, which are used to make a wrapper object in the 
addRawDataltemQ call. This means that the addRawDataltem method in the 
"properties" class is predefined within the XIS fi:ameworic This addRawDataltem 
method will ultimately result in the invocation of the reflection feature of Java so that 
15 the various attributes contained in the data source HelloWorld object are exposed to 
be used by the PropertySheetlofo. 

The PropertySheetlnfoBean uses the wrapper to access the attributes for 
display and, if necessary, enable the user to update the e^qx)sed attributes of the 
object Inthisexan:tple,however, none of the attributes are editable. The 
20 PropertySheetlnfoBean also fires a close event when a "Cancel," "OK," or close 
button is pressed. The next portion of code 1608 sets up a Java listener to exit the 
program when the appropriate button is pressed 

The last portion of code 1610A and 1610B creates a IFrame (Java frame) to 
display the INFOBEAN (it extends java^awtComponrat). A Ustener is added to exit 
25 the program when the window is closed. 

Figure 17 shows the resulting display application on INFOBEAN called 
PropertySheetlnfoBean, Example 1 is very simple, as it simply displays the attributes 



57 



wo 02/46916 



PCTAJSOl/48418 



exposed for the Hello World object in a tabular fonnat Pressing a "close window" 
display button causes the application to exit 
Example 2 

Figures 18A, 18B, 19A, and 19B list two Java soinxe files. These two Java 
5 source files function similarly to those listed in Figures IS and 16. Modifications or 
additions to &e code listed in Figures 15 and 16 are marked with "/* {♦/" <new code 
here> 7*} */) ." The resulting output is shown in Figure 20. 

Figures 1 8 A and 1 8B extend the previous HelloWorld class (Figure 1 5) by 
using the JavaBean standard property change event distribution classes so that other 
10 XIS objects are automatically notified when its properties are changed (within the set 
methods). The java.beans J^ropertyChangeSupport instance takes care of maintaining 
lists of Usteners and sending events to them. It is only necessary to implement 
wrapper methods to pass listeners to this contained instance (the first block of new 
code after the in^orts 1 802) and then to call the firePropertyOiange method 1 804 on 
15 it when anything is actually changed This is performed m the setValue 1808 and 
setMyColor 1810 methods. Value and My Color are editable fields. 

Figures 1 9 A and 1 9B contain tfic TestHamess file. Similar to Figures 1 6A and 
16B, the TestHamess file contains code to expose an mstance of this object within 
XIS. In tins case, not only are the properties or attributes displayed using a 
20 FropertySheetlnfoBean, but a charting program, ChartlnfoBean, i.e., another data 
consumer component uses the same data item to display a chart accordingly. The 
ChartlnfoBean automatically searches for nxxmeric attributes on the data item and 
plots them accordingly. The Numeric attributes are recognized as such through 
reflection when the raw data item, HelloWorld object, is wrapped within a 
25 LeifDataltem object. 

Similar to Figures 16A and 16B, the TestHamess file contains code to expose 
an instance of this object within XIS. In this case, not only are the properties or 
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attributes displayed using a PropertySheetlnfoBean, but a charting program, 
ChartbifoBeaQ, i.e., a data consumer component feeds tihe same data item to display a 
chart accordingly. The ChartlnfoBean automatically searches for numeric attributes 
on the data item, and allow them to be plotted. The Numeric attributes are recognized 
5 as such through reflection when the HelloWorld object was registered within the XIS 
fiamework. 

The first portion of code 1902 sets up a property sheet INFOBEAN similar to 
Example 1. The second new code portion 1904, marked in the drawing by comment 
braces, sets up a second frame and puts a ChartESTFOBEAN into it Since the chart 
10 can display multiple data items, the method to feed it data items (addRawDataltems) 
1906 takes an array of objects. The method setChartType 1908 may be used to 
specify the type of chart, its axes, and so on. 

Figure 20 shows the PropertySheetlnfoBean displaying the attributes of the 
data item, i.e., the HelloWorld object The charting component is not shown in the 
15 figure. 

Example 2 application puts up two windows-a property sheet displaying 
information on a HelloWorld object and a chart display (alternatively called a "plot" 
display) showing one or more of tibe numeric attributes of the same data item. On the 
property sheet, editable fields are surrounded by a darker gray background. In 

20 particular, one may change the "My Color" property by clicking on it Clicking on 
this property brings up a default editor for color attributes defined wiftin this 
firamework. In this embodiment, numbers, strings, dates, and several other kinds of 
attributes all have appropriate editors automatically set up for them within XIS, via 
the TypeMetaData facilities. 

25 The chart starts out displaying either the ID or the Value attribute. It may be 

changed by clicldng on the Y axis label. This is also the way to set which kind of 
chart (bar, line, pie, etc.) is uised. If the value being plotted (or the color) is changed 
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in fihe property sheet (and the display button "Apply" is pressed), the chart • 
automatically updates. Similarly, right clicking on the part of the chart corresponding 
to a data item enables a user to bring up its property sheet In this embodiment, this 
kind of coordination is maintained automatically within the XIS framework through 
5 the use oftheJavaBeans event mechanisms. It should be noted that when the 

application is run or executed, the color of the chart does not match the one set in the 
property sheet. This is because, although the PropertySheet recognizes that any field 
of type "java.awt Color" is displayable and editable as a color, the chart has no way of 
knowing which color field (if there are more than one) should be used. This may be 

10 solved, however, within the firamework by using standardized Domain Attributes. 

In one embodiment of the invention, Translators are used within the XIS 
framework. As described earlier, a DSI e;q)0ses data information within the XIS 
framework for data consumers to use. Java reflection and introspection may be used 
to obtain attributes specified in simple objects and JavaBean, respectively. The XIS 

15 framework first searches for a Translator class for the data source object. Translators 
are therefore optional considering that the attribute values and attribute descriptors 
may directly be obtained &om an object Translators may also be used in order to 
keep tiie object's class simple so that it is capable of being used in non-XIS 
environments. 

20 In an embodiment. Translators are somewhat similar to the Beanlnfo class in 

JavaBeans. Like the Beanlnfo class, &e name of tiie class must begin with the name 
ofthe data class followed by "Translator". For example, a DSI class named 
PlanObjectjava would have a corresponding Translator class 
PlanObjectTranslator.java. Also, similar to Beanlnfo classes. Translators must reside 

25 in the same class space in which the DSI is located. For special circumstance cases 
such as non-localized objects or custom Translator definitions, a Translator registry, 
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e.g., TransIatorRegistry, may be used to register a Translator for a given data item 
class. 

Table VDI below shows an exemplary code to register a Translator within the 
XIS framewori- 



TableVni 
// register the translator for File objects 

TranslatorRegistry.getTranslatorRegistryO 

.registexObjectSchema(PlanObjecLclass, 
PlanObjectTranslator.class); 



The above code, as well as all code discussed herein, is provided to illustrate 
the functional behavior described h^ein. One of ordinary slrill in the art wUl be able 

10 to produce the code, for example, to create classes, objects, APIs to affect iJris 
Translator registry. 

When the value of an attribute is requested from a data soinx:e component, 
using the mediation layer, the value from fhe attribute methods specified in the 
Translator, if any, is exposed If the Translator does not exist, then the method in the 

15 object is invoked, i.e., the get+attribute method wiftin fhe data source object. The 
Translator may directly invoke fhe object's methods as well. The Translator may also 
be used to wrap legacy code. For example, if fhe object class is a legacy code, which 
may not be modified, and has a color property, a Translator may be written to return 
fee value of fhe color, for example, for the DisplayDomain.color attribute. In this 

20 way, the information may be accessed without modifying the original legacy code. 
The data in fhe data source object in effect has been normalized or tailored to the 
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domain policy specified The XIS framework in this embodimeat pro\ides the ability 
to integrate existing data item classes without modifying them. 

To integrate a data item class into the XIS framework, an accompanying 
Translator class should be provided. In this Translator class, the data source 
5 developer provides code that reaches back into the data item^s class to expose its 
properties. It also serves as a way of normalizing access to these properties by 
imposing a common interface for all Translators to implement. 
Translators have two primary functions: 

(1) Translators provide an intermediate method from the caller of an attribute 

10 "get" or "set" method to the data source object, enabling a developer to translate the 
value from its internal representation to a representation understood within the 
framework, particularly, by the data consumer components. For example, an object 
may store a defeult color as a string color name, but the Traiislator may convert that 
color to a java.awtColor object 

15 (2) Translators also enable a developer to define attribute types more precisely 

(e.g., via AttributeDescriptor code, which provides detailed TypeMetaData and may 
map attributes to specific domains). This resolves any ambiguity in the attribute type. 
It should be noted that reflected properties that are converted into XIS attributes cany 
minimal semantics, which contributes to the useftJness of the XIS fpmework. For 

20 exanaple, "float getDegreesQ'* by itself does not imply whether it provides an angular 
measure or a tenrpexature measure, nor does it imply that the valid range is from 0 to 
360 or from 0.0 to 2,0 pi for angular measures, or distinguish between Fahrenheit, 
Celsius, or Kelvin for temperature measures. 

Translators also enable developers to convert objects that do not follow the 

25 JavaBeans get/set API design pattern. For instance, a data item could be implemented 
as a mq)ping of attribute names to values (e.g.. String, Integer, Double, and Boolean). 
The Translator may map actual XIS attributes to these key/value combinations, 
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making XIS data items appear as if they were generated j&om the more typical 
JavaBeans-style objects. Example 3 shows how a Translator may be implemented in 
the XIS framework. 
ExampJe 3 

5 Example 3 application is contained in three source files listed in Figures 21 , 

22A, 22B, 22C, 23A, 23B, 23C, and 23D. The resulting ou^uts are shown in Figures 
24Aand24B. 

Example 3 functions similarly to Example 2 above, but enable finer control 
over the data item attributes exposed within XIS. In particular, flie HelloWorld object 

10 is explicitly wrapped in a Translator rather than simply feeding it to XIS and letting it 
rely on reflection to display and manipulate the data. This allows some properties of 
fee raw data item to be hidden, and allows other ones to be better **understood" within 
XIS. The Hello WoricfTranslatorjava file contams the Translator. 

Referring to Figure 2 1 , the property change event-handling portion of code 

15 1506 found in Figure 18A has been removed from the set methods. These functions 
are now handled in the HelloWorldTranslator class (Figures 22A-22C), which is 
registered with XIS by the TranslatorRegistry static call at the beginning of that clasps. 

Referring to Figures 22A to 22C, this file contains the HelloWorldTranslator 
class 2202 that wraps the HelloWorld object When an INFOBEAN encounters a raw 

20 data item, it ultimately accesses the raw data item through a Translator's methods, if a 
Translator exists. In one embodiment, all Translators are subclasses of the 
com.xisieif.im.Translator class, which provides an infrastructure tihat facilitates the 
use of attributes already defined or set-up in an XIS Domain* Such attributes have 
type metadata predefined for them, and many XIS INFOBEANs automatically access 

25 and utilize the metadata and the attributes themselves. 

The first menaber variable 2204 of the HelloWorldTranslator class Ksts the 
predefined XIS domains fix^m which attributes are taken. In order to use an attribute 
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not in one of these domains, it may be necessary to provide a separate metadata for it. 
The second member variable 2203 defines an array, which lists auxiliary information 
on the fields, in this case, whether they are displayed by default in the property sheet 
display. The getFieldMetaDataArray method 2206A and 2206B fills this array, if 
5 necessary, with the defeult metadata for the fields that are exposed by the get and set 
methods fiartiher listed below in the source file. The exception to the defeults is that 
the "course" attribute 2208 is not visible, i.e., it is not displayed under the "Preferred 
Attributes" on flie property sheet It is displayed, however, when the "All Attributes" 
option is selected. Other things that may be set (but are not in the source file) include 
10 the sorting order and rank when multiple data items of this class are listed together, as 
in a table. 

The CTSuing get and set methods 2210 define the attributes that the rest of the, 
XIS objects can see. In general^ this refers to the enclosing raw data object, but this 
need not always be the case. For example, here, the HelloWorld's integer Value' 

15 property is map to the 'speed' attribute, which takes its metadata and its type (double) 
jfrom the Movement domain 2212. The Movement domain has previously been 
defined. By handling conversions within the Translator, the rest of XIS ''never 
knows" that there is really an integer value underneath. 

All change event propagation is handled 4rough the request objects passed 

20 into the set methods 22 14. Similar to Example 2, all XIS objects using the same data 
item are notified of the change. 

Referring to Figures 23 A through 23D, the TestHamess code is largely 
unchanged firom Example 2, but at the end it includes a separate class that 
demonstrates how attributes may be altered on a data item tiiat includes a Translator. 

25 In general, the procedure is to obtain, first, the Leifi^ataltem corresponding to the raw 
data item, then a "domain wrapper" that wraps this and enables access to attribute 
that come under that domain. Internally, the domain wrapper calls methods on the 
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Translator, but externally it presents an interface to the developer that depends only 
on the domain and not on the particular LeifDataltem being wrapped. 

The code in the Accelerate class is a standard thread implementation that uses 
the wrapper to successively change the HelloWorld data item's speed attribute. In 
5 oflier embodiments, this attribute may be altered by any portion of the program that 
has access to liie data item* Because ftie wrapper eventually calls the Translator, the 
change events are propagated appropriately. 

The Example 3 application, similar to Example 2, displays two windows--a 
property sheet and a chart. Example 3 shows that the property sheet may be made to 
10 display more properties (in this case, the "couKe" attribute) by selecting "All 
Attributes" from the top menu, which ignores the "preferred" setting in the 
FieldMetaData. The attributes all have reasonable names, which come from flie 
metadata stored in the domains. Finally, if the "Pen Color" attribute is edited, the plot 
changes color accordingly. This is because the Chart INFOBEAN recognizes and 
15 uses the "P^ Color" attribute from the Display Domain if it finds one on the data 
item. Because of the various wrappers employed, it does not matter what kind of 
object is eventually undraieath or what other attributes it has; as long as &e "Pen 
Color" attribute is found, it will be used. 

Example 4 

20 Example 4 contains two source files namely HelloWorld and TestHamess. 

Figures 25A to 25C list the HelloWorldjava source file. This example shows 
translation without a Translator class. The resulting output is a property sheet 
INFOBEAN and a Chart INFOBEAN. Figure 26 shows the property sheet InfoBean, 
but Ihe ChartlKFOBEAN is not shown. The HelloWoridTransIator.java file from 

25 Example 3 is eliminated. Similar to above, the HelloWorldjava file has been marked 
such that dianges from Example 3 are marked by open and close commented braces. 
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The Java source files enable some of the same fine control over the attributes 
exposed within XIS (see Example 3) without using a separate Translator class. If a 
developer has control over the Java code for the data source, the overhead of using a 
Translator may be eliminated by building some of its functions directly into the data 

5 source. It may, however, still be desirable to use a Translator because this avoids 
building any XlS-specific code into the JavaBean created and enables the code to be 
. more streamlined for use in non-XIS contexts. 

Figures 22A to 22C contain the Hello World code, which include some of the 
code from Example 3, with some additional code for exposing attributes and 

10 providing field metadata as the HelloWorldTransIator class in Example 3, In £act, 
ahnost everything may be done from within this data item class that could be done 
with a Translator except for two things. First, attributes cannot be hidden from XIS— 
everything with a getQ method is exposed. Second, Translators may be used in 
conjunction with security features, for example, embodied in the XIS framework to 

15 restrict access to visible properties in a generalized fashion across all data items. 

The first portion of code 2502 provides methods for XIS to obtain information 
on which data item properties have attribute information provided for them. The XIS 
components first introspect on the data item to find its properties, then try to call the 
get(property name)Descriptor for each property. For those instances where this fails, 

20 the XIS component may provide its own attribute descriptors where it recognizes the 
type of the attribute. For example, the property sheet recognizes Color, Numeric 
(various subtypes). Date, and String attributes. The next portion of code 2504 
initializes a PropertyChangeSupport instance^, because property change events must be 
handled here, similar to Example 2. 

25 Following this are several methods unchanged firom Example 3, but the setQ 

me&ods have been altered to resemble those from Example 2 in which property 
change events are fired. Next, there are several new getQ and setQ methods which 
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expose the properties with the same names as the Translator did in Example 3. These 
names correspond with the getAttributeDescriptor methods listed above in the code, 
and the XIS components interpret them accordingly. These properties show np as 
preferred attributes in the property sheet, whereas those properties without 
5 corresponding attribute descriptors become nonpreferred attributes. 

The portion of new code 2506 following this provides field metadata for this 
raw data item. Hiis program code is almost identical with thpse in the Example 3 
HelloWorldTransIator, except that both the variable and the method are now static, 
and the "Course" attribute removed to reduce clutter, 
10 * The Teslflamess file for Example 4 is generally unchanged from Example 3, 

except the code to register a Translator is removed. The portion of program code 
2302 in Figure 23A is removed in this example. 

This Example 4 q>plication is largely similar to Example 3, except that if the 
"All Attributes" <q)tion is chosen under the property sheet, then the previously 
15 unexposed "value", "myColor", and other attributes appear. The chart is also able to 
display the "value" and "ID" properties. 

Figure 26 shows a window display of the property sheet output from the 
Example 4 application. 

. Processing Flow for Exposing Data 
20 Figure 27A and Figure 27B show a flow diagram of how information about a 

data item, e.g., a data item as shown in Figure 5, is exposed to data consumer 
components, in the preferred embodiment, data exposure within the system may be 
accomplished by one of three methods, described further below. There are two 
primary functions to be performed (1) interfecing with an internal or external data 
25 source such as a set of disk files, a database, or a web service; and (2) exposing the 
r^ulting data according to the standard interface outlined above, e.g., following the 
4omain interface, relationships interface, and the like. 
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In the first method of exposure, one software component performs both 
functions; in the second method, separate software objects perform the two fimctions; 
in the third method, which is only implementable in an object oriented programming 
language that provide self-analysis facilities, such as Objective C or Java, the 
5 exposure ftraction is performed automatically by the system. More particularly, in the 
first method, a data source interface (DSI) software object is written that connects to 
an external data source such as a local file system, an Internet site, or an RDBMS. 
The DSI object converts the information provided by the external data source into tiie 
information representation or data item that may be consumed by data consumer 

10 objects as described above. In a preferred embodiment of the invention, the data 
• source DSI objects are from the LeifDataltem class. 

In the second method, the API of an existing software data object is accessed 
. by a Translator object, which then exposes the information to other data consumers in 
the representation format discussed above. This arrangement is referred to in the 

15 object oriented design Uterature as an Adapter or Wrapper pattem. See, for example. 
Gamma, E., Helm, FL, Johnson, R., Vlissides, J. (1995); Design Patterns: Elements of 
Reusable Object Oriented Software; New York: Addison-Wesley. This is generally 
referred to as "wrapping**. More precisely, a data consumer carc5>onent requests 
information from the Translator object, which then converts the request into 

20 something flie original data source object can deal wifli. The consumer then converts 
fliat object's response into the appropriate format for a response to the original call. ' 

The third method applies the facilities witbin a setf-analysis-capable 
programming language such as Java or Objective C, This type of programming 
language enables an object to determine the available data fields and function calls 

25 afforded by ajaother object while an application is running. In the preferred 

embodiment implemented in Java, die queried object must be a "JavaBean" according 
to Sun Microsystem's suggested convention, with "getQ" and "setQ" method calls. 
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Each data field available through one of these calls, or by virtue of being a "public" 
variable, is examined, and the resulting type information is used to expose both the 
field's value and ^ropriate metadata to data consmners. If the field is a numeric 
type (double. Double^ float, Float, Integer, int, long, or byte in Java), it is exposed as a 
5 decimal or integer with an "unknown" imit of measure. If the field is a string (String 
in Java), it is exposed as a text element If the field is a complex object, it is exposed 
as a linked element via a reference (discussed above), unless a special class has 
registered to handle the coir5)lex object type within the application context or XIS 
jftamework. 

10 In another embodiment, in addition to tike facilities for exposing data, die XIS 

ftamework provides an apparatus for allowing application context to affect how 
information is exposed. This is illustrated in Figures 27A, 27B, and 28, described 
further below. The attributes, methods, and relationships available for a given data 
source are detennined by a surrounding structure called an InfoModel. The 

1 s MoModel connects the pieces of the XIS firamework together. It is an inter&ce 

comprising an object that knows how to return data item information. See also Figure 
3 A discussed above. 

In another preferred embodimeat, an application comprises one or more Views, 
each containing and providing an InfoModel to one or more data consumers, termed 

20 INFOBEANS as described above, which may provide display, computational, or 
interactive facilities. All of the Views are in turn managed under a single ViewHost, 
which provides the global application context. Conceptually, a view represents a 
single perspective of the current data. One single perspective (or view) could be quite 
different fi-om another because of the ability to add/override attributes in a view. 

25 View creates a new InfoModel that in turn creates new LeifDataltems that are used 
within tiiat view. This is done to separate context sensitive attributes between an 
' InfoModel and another View, INFOBEAN, or InfoModel. Views are also used as a 

69 



wo 02/46916 



PCT/USOl/48418 



controller of one or more INFOBEANs by managing the data flow to each individual 
INFOBEAN- All Views are also by definition INFOBEANs since fliey manage 
information flow witii generic means. The ViewHost is used to manage the complete 
set of Views and INFOBEANs, thus presenting each view to the user in a unifonn 
5 fashion such as ftames, windows or other display mechanisms. 

Figure 27A and Figure 27B show a flow chart of a data exposure facility 
within the XIS framework constructed in accordance with the present invention. The 
diagrammed operations will occur when the XIS framework is loaded into program 
memory of a computer system that supports an object oriented programming (OOP) 

10 environment, as will be understood by those stalled in the art. In the first processing 
step, at block 2702, a data source object is registered within the XIS firamework of the 
computer system. When a data item is brought into the framework, it is exposed to 
data consumer objects, e.g., via an InfoModel, typically via one of three methods. The 
first operation is to determine whether a Translator object is available and whether the 

15 Translator object is registered for the raw data object type. This processing is 
represented by the decision block 2704. 

If the Translator is available, an affirmative outcome at the block 2704, then at 
block 2760 the data item attributes, methods, and Domains are obtained via the 
Translator. If the Translator is not available, a negative outcome at 2704, then at 

20 block 2706 the data item object is scanned to find the data object's methods. The 
scanning may be accon^lished wi& facilities of the OOP environment of the host 
computer system, such as InfoBeans. 

Afier the data item object has been scanned at block 2706, the system next 
checks to see if the data itpm includes an XlS-standard data e:q>osuxe interface (&at 

25 is, a predefined interface known to the XIS fiMiework). If the standard mterface is 
available, an a£5rmative outcome at block 2714, tiien at block 2762 the data item 
object attributes, methods, and Domains are obtained from the data source object 
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itself. The system then checks for references to Domain Policies at block 2763. if 
there is no standard interface available at the decision block 2714, then processing 
moves to the block 2764, where the fecilities of the programming language of the 
OOP environment axe used to interrogate the data item object to determine the object's 
5 accessible data fields. Processing then moves to exposure attribute processing via the 
ofF-page coimector B to Figure 27B, described below. 

Returning to block 2762, after the data item attributes, methods, and Domains 
are obtained, a check is made for Domain PoHcy references at the decision block 
2763. If there are references to Domain Policies, an affirmative outcome at tiiie 

10 decision block, then at block 2765 a check is made to determine if there is 

FieldMetaData override for a Domain. If there are no Domain ovemdes, then at 
block 2710 the definitions from the referenced Domain Policy are used for tiie 
attribute metadata. The processing then moves to exposure attribute processing via 
flie oflP-page connector A. If there are Domain overrides, an afGrmative outcome at 

15 block 2765, then at block 2716 the system uses the definitions included wife the data 
item object Translator for the attribute metadata of the data item. The processing then 
moves to exposure attribute processing via the off-page connector A. Referrmg back 
to block 2763, if there were no references to Domain Policies, then processing 
proceeds straight to block 2716 to obtain the attribute metadata definitions and ttien to 

20 the ejqposure attribute processing via fee off-page coimector A to Figure 27B. 

Turning to fee processing of Figure 27B via fee off-page connector A, fee data 
item attributes are exposed to fee local InfoModel class (i.e., a DSI object). Next, at 
fee decision blodc 2770, a check is made to determine if fee data item has any 
dynamic attributes. If fee data item does, feen at block 2772 fee fimnework 

25 processing adds fee dynamic attributes to fee available data item attributes. If fee data 
item has no dynamic afeributes, or after any dynamic attributes have been added, 
processing moves to block 2773, where fee system checks to determine if a Translator 
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was provided (registered) for the Data Source object If a Translator was provided, 
then at ttte decision box 2775 the system checks to determine if reflection has been 
requested Those skilled in the art will understand that reflection is an operation that 
is provided by most OOP environments, such as by Java. 
5 If reflection is to be performed, then processing returns to Figure 27 A via the 

off-page connector C, whereupon the Data Source is scanned. If reflection is not to 
be performed, or if no Translator was registered (a negative otitcome at block 2773), 
then processing moves to the decision block 2774. At block 2774, the system checks 
to detemiine if the data item has registered any extended Translators. If there are no 

10 extended Translators, then at block 2718 the data item attributes are derived, added, or 
hidden, depending on the data context gleaned from the DSI. The data item is then 
fully exposed to data consumer components for xise (block 2790), If there are 
extended Translators, an affirmative outcome at block 2774, then processing returns 
to Figure 27A via the off-page connector B to obtain the information from such 

15 Translators (block 2760). 

Figure 28 is a diagram showing how InfoModels provide contextualization 
within the XIS framework. The initial "raw" object (e.g., Java object ox data from 
RDBMS) provided by the data source is exposed through mediation by successive 
''wrapping layers" of other objects, which determine which fields axe visible, and 

20 possibly performs conversions or consolidations. Each "View" within the XIS 

framework, which contains one or more 'INFOBEAN" consumers, cames with it its 
own context. Feeding a data source component to a consumer component places it 
within that context. 

When a data element provided by a data source is introduced to an InfoModel, 
25 the InfoModel actually provides a new element derived from this one to constnners. 
This derived element provides the actual data source interface discussed above. The 
attributes, type metadata, and methods provided for the element are first determined 
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as described below under "data exposure facilities"- Theu the InfoModel inspects the 
results and decides whether to add or derive any new attributes, or to hide existing 
attributes. Once the data is added to an InfoModel (discussed below), it may be asked 
for by other components for processing and visualization purposes. 
5 In another embodiment, the ViewHost, a data consmner component, provides 

facilities allowing interactive cut and paste and drag and drop of information elements 
between different consumer components. When a cut-and-paste or drag-sand-drop 
occurs, each information element is decontextualized and then recontextualized inside 
the new InfoModel into which it is placed. This means that spme attributes 

10 previously available may be removed, whereas others, more appropriate to the 
functions of the recipient consumer(s), may be added. 

Referring back to Figure 28, this figure shows how multiple InfoModels work 
to share references to raw objects^ This figure also illustrates how an INFOBEAN 
and/or a DSI adds objects to the InfoModel to obtain data items. The DSI 2815 

15 creates an instance of source raw data item (e.g., Java object) 2830. The original 
source objects are maintained by DSI and one or more InfoModels have references to 
these source objects. The raw data item 2830 is pro\dded to or may be used by an 
INFOBEAN (data consumer) via the addRawDataltemQ method. (Please refer to 
Table III above. The second line of code shows that the source object is added to tiie 

20 TablelnfoClass.) 

The INFOBEAN 2820 requests the data item for flie raw object 2835 (which 
was the source object 2830) from its InfoModel or the BaselnfoModel. The 
BaselnfoModel as discussed above is responsible for creating and caching evezy data 
item (wrapping any object). Each hifoModel is considered to contain a subset of data 

25 items &am fee entire set of data. The InfoModel is a view of the BaselnfoModel, 
thus, there may be data items in the BaselnfoModel that are not present in fee 
InfoModel used by the INFOBEAN. The circles 2828 shown m fee InfoModel 2805 
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represent attributes, domams, relationships, etc. fix^m the BaselnfoModel. For 
example, Figure 6 contains a list of infonnation tiiat an INFOBEAN may obtain about 
the Person object, m this case 2830, 2835, through the LeijQDataltem API. In addition 
information from nested InfoModels arc inherited. An InfoModel 2805 also always 
5 adds new items to the BaselnfoModel, e.g., common attributes such as "^selection" are 
delegated. These new items are also exposed to the INFOBEAN as shown by the 
number of circles in 2840. 

The BaselnlbModel 2810 returns the raw data object 2845 to the MbModeL 
The InfoModel 2805 returns a data item 2840, which exposes the infonnation, for 
10 . example, shown in Figures 4 and 5 to the INFOBEAN 2820. A data item 2845 (see 
Figure 4) is returned, which may have been created or may have already existed in the 
InfoModel. 

In the XIS framework, as shown in the InfoModel, attribute and method 
"requests" mechanisms are available. Standard mechanism to retrieve the current 
15 value of any Attribute, or set the current value, if the Attribute is mutable, may also be 
. easily implemented. In one embodiment, this mechanism also enables a standard 
syntax and mechanism for thejnvocation of any domain method. 

These attribute and method "request" objects contain all of the information 
necessary for the data source to fulfill the requested task. It contains the actual 
20 C^w") data item whose attribute value is being sought or set (along with the desired 
new value), or whose domain method is being invoisd. They also contain contextual 
• information, such as the current User, allowing data source developers to implement 
fiiU user-based infonnation access and security controls, and a context for obtaining 
services (implatnented through the Java 'BeanContext" APIs). This is significant 
25 because it enables the pirocess of executing me&ods and/or getting or setting values to 
leverage services "in context" such as the current data view (or window) through 
which to interact with the user. These request objects also contain contextual "data 
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item" (e.g., LeifDataltem), as opposed to the "raw" non-contextual data item, from 
which to get additional or overridden values or execute additional/overridden 
methods, if appropriate to the task. In another embodiment, these "Request" objects 
are not only passed when getting/setting values, or executing domain methods, but are 
5 also passed to all other 'Translator" methods that take and may need to access or 
manipulate the data item. The "Request" object not only provides context, but also 
ensures tiiat the DSI (via the Translator) always has what it needs (particularly, the 
User ioforraation) to manage its security constraints, if any. 

A data item locking mechanism for obtaining, holding, and releasing a lock on 

10 an individual data item may be implemented in accordance with the present invention. 
This implementation is best defined by the data source provider, by implementing 
such locking mechanism in the data source, itself Ad hoc implementations for data 
sources that do not provide native locking may also be done via the DSIs. This 
mechanism enables DSIs to implement multiple changes atomically (as one 

15 transaction) by effecting those changes at the time of iJie release. In addition, a 
"rollback" featm-e for atomic changes is possible through the "revert** capability, 
which generally releases the lock without ajBfecting the previous changes. This 
locking mechanism may also be leveraged to lock multiple objects simultaneously, at 
Ihe discretion of the DSI, by associating the lock wift a DSI-defined 'lock object" 

20 which can either be associated with a single data item or with a group of data items, as 
appropriate. Using the DSI API, this provides to data consumers a single API for 
dealing with locking implementations. 

Figure 29 shows an CTibodiment of a "plug^in manager" called PluglnManager 
of the present invention. The jMrogranaming framework embodied in this invention 

25 includes a "plug-in manager" which provides extensible communication between 
services and components within an application. Plug-tns are software modules that 
add a specific feature or service to a larger system (i.e., plug into a larger application 
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to provide functionality). For example, there are a number of plug-ins for the 
NETSCAPE NAVIGATOR browser that enables the browser to display different 
types of audio or video messages, e.g., SHOCKWAVE by MACROMEDIA, 

A "service" is capable of obtaining information on a data consumer or data 
5 source component and capable of nsing that information to provide specific facilities 
. to the application as a whole. Examples of such facilities include addition of entries 
to a top level application menu, loading MIME types into the global MIME type map, 
and running of scripts upon loading or unloading of data sources or consumers. The 
plug in manager loads new services at initialization and also at any time through an 
10 explicit request. The service in turn queries all modules present in the application as 
to whether they request any actions of the given service, executing them if so 
indicated* 

In more detail, as each new module, object, or component is loaded into the 
XIS fiamework, the PluglnManager 2905 on startup loads a special service called 

1 5 PluggableServiceFinder 2925, which searches for other services 291 5 and loads the 
services found into fte PluglnManager 2920. The PlugTnManager holds or keeps 
track of all services. These services are referred to as PiuggableServices. As each 
pluggable service is loaded, the PluglnManager searches such service for defined 
resources and attaches these resources to the appropriate components or performs 

20 actions on resources found 2935. For example, a menu manager service might search 
for resources specifying menu entries and associated operations. A component that 
wants to add a menu entry to the global application menu bar would simply provide a 
resource of this type. In essence, as each new module is loaded, tiie PlugilnManager 
tells the currently registered services ("PiuggableServices") to look for new plug-ins. 

25 Thus, in essence tihie PluglnManager acts as a plug-in for plug-in handlers. 

The combination of the PluglnManager and the PluggableScrvice interface 
allows ccHiununication between an XIS ^plication and various XIS coir^onents. The 
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components may contain a number of resources that affect certain areas of XIS. For 
example, fliey may have a resource file that contains an ECMA script. ECMA is an 
international industry association dedicated to the standardization of information and 
communication systems (see www.ecma^ch). If there is a PluggableService that 

5 knows about that resource file, then it may decide to run the ECMA script when it 
finds the resource. The PluglnManager is responsible for managing the resource list 
and all PluggableServices. When a new PluggableService is added, it is given all the 
resources to detennine if it is interested in any of the resources on the list. If it is 
interested in a resource, then it may perform some action, 

10 In one embodiment of the invention, an ASCII file is created to indicate that a 

JAR file contains a resource to be provided to all PluggableServices. 

Table DC below shows an exemplary ASCII file that indicates that there are 
resources associated with the module containing the TableView class. It does not 
indicate what resources exist; it is up to tiie PluggableServices to detemmie if there is 

15 a resource in which they are interested. The PluglnManager, using Class.forNameO, 
creates the Table View.class and calls tiie loadPlugIn method on each of the 
PluggableServices. Below is the content of the loadPlugln method in the 
MimeTypesPluggableService: 



Table DC 

public static final String RESOURCEJNAME = 'leifResources/mime.types"; 
public void loadPlugIn(Class relativeClass) { 
if (loadedResources = null) { 
synchronized (this) { 
if (loadedResources = null) { 

loadedResources = new HashSetQ; 
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} 

} 

} 

1ry{ 

String resource ~ PlugInManager.convertResourceName( 

relativeClass> RESOXJRCE_NAME); 
ClassLoader loader = lelativeQass.getClassLoaderO; 
Enximeration enum = loader.getResources(resource); 
while (enumJiasMoreElemeiitsO) { 

URL resourcellRL = (lJRL)eimm.nextElementO; 

if (resourceURL !== null) { 

if (!loadedResoxircesxontains(resoiircelIRL)) { 
loadedResources.add(resourceURL); 

Lei£rAFUtilities.addMimeTypes( 

baselnfoModel.getOwncdBeanCmtextChildO, resourceURL); 
} 

} 

} 

} catch (lOBxception e) { 
e-printStackTraceO; 

} 

} 



The entire airangement of data sources separated ftom consumers by a 
mediating structure, InfoModels providing context to Views, and a ViewHost and 
5 plug in manager playing set central organizing roles, allows a multi-purpose 
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application to be rapidly assembled out of preexisting components. Each available 
data source and consumer component may be integrated into the application by the 
plug in manager, and compartmentalization* 

Figure 30 shows a flow diagram of an embodiment of the invention that assists 
5 in creating XML (extensible markup language) DSIs and database DSIs. The XIS 
framework provides two sets of facilities for exposing electronically available 
^ information that comes from data sources that are partly structured and/or self- 
describing, and for writing back possibly modified information to the sources. For 
example, one of these works for XML formatted data, and the other works for data 

10 stored in relational databases. However, the mechanisms are inherently extensible to 
any other data source that is partly structured and/or self-describing. 

The World Wide Web Consortium (W3C), which has standardized most of the 
XML formats to date, is in the process of defining a new XML format for declaring 
schemas, called XML Schema. The XML schema addresses the means for defining 

15 the structure, content, and semantics of XML documents. The present invention is 
configured to take into account future versions of the XML schema. 

In one embodiment, the present invention includes aspects of the method 
outlined below that are in common between the XML and relational database 
interfaces and can be applied in this general capacity to be part of the invention as 

20 well. In particular (described further below), an embodiment includes the apparatus 
involving separate processing of "data" (3002 branch) and "schema" (3004 branch) 
information, with a type conversion stage 3012 during the former and a metadata 
creation stage 3014 during the latter, followed by the construction of semantically 
enriched attributes 3016, 3018 based on the results of both tiiese processes. 

25 In one embodiment, one method involves two apparatus or &cilities d^gned 

to handle extensible markup language (XML) formatted data. An XML text stream 
comprises of a set of hierarchically structured 'tags" interspersed wife text "content". 
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The names, data types, and ordering of the tags may vary from stream to stream and is 
specijBed by a separate document called an "XML schema." A description of the 
XML schema is provided in ftie document "XML Schema Part 1: Structures (Working 
Draft)", which may be obtained from the W3C at the WWW address of 
http:/Avww. w3.org/TR/xmIschema-l, and also in the docxmaent "XML Schema Part 2: 
Datatypes (Working Draft)", which may be obtained at the WWW address of 
http://www.w3.org/TR/xmlschema-2. Given an XML data stream, the first apparatus 
parses the XML schema appropriate for it and constructs metadata specifications 
appropriate for the contents of each tag. In some cases, these specifications are in the 
form of computer program segments that can be compiled into executable procedures 
that can be accessed immediately by a running application; in other cases, they refer 
directly to abeady precompiled procedures. The second apparatus parses the data 
document, matchiag the tags up with the types and metadata derived from the schema, 
and exposes the content in the standardized information representation using this 
metadata. This information includes the generic relational links described above in 
addition to attributes and metadata. 

In particular, the structures defined by an XML schema document determine 
the hierarchical and type structure allowed in XML instance documents, and this 
stracture is paralleled again in the information elements (with attributes and member 
elements) constructed on parsing an instance. The following table (Table X) shows 
the correspondence: 
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Table X 


XML Schema 


Compliant XML 
Instance 


Resulting hifbimation 
Element 


simple type outside attribute 
declaration 


element with no 
subelements 


(typed) attribute 


simple type inside attribute 
declaration 


attribute 


(typed) attribute 


complex type without 
descendents 


element with attributes 
but no subelements 


information element witib 
attributes 


complex type with 
descendents 


element with 
subelements 


informatton element with 
member elements 



A complexType element, as defined in the W3C XML Schema standard, 
defines the structure of an information element. Elements contained within the 

5 complexType element which axe deigned as complexTypes themselves, are translated 
into the member elements of the information element defined by the containing 
complexType. All other elements and attributes contained within the complexType 
element, and defining single value types, are translated into attributes of the 
information element defined by the containing complexType. 

10 The XML ingestion process supports an additional capability that allows for 

the translation of types defined by an XML Schema, into more semantically rich 
domain policy based attributes that consumers in the present jframewoik can take 
advantage of. To do this an embodiment of the present invention includes a process 
that uses XSLT (XML Stylesheet Language Transformations) to scan an XSDL 

15 (XML Schema Definition Language) document, and embed domain specific 

instractions in a new version of the XSDL document The embedded instructions 
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direct the XML processing software to create information elements that contain the 
semantically ric|ier domain attribute representations. In particular, the tags in the 
table below may be placed by the XSLT within <appinfo> subelements of elements in 
the XSDL schema document. When the schema parsing apparatus reads the resulting 
5 schema, it sets up the XML processor to perform the m^pings as shown when 
reading an instance document. Because of the nature of the handling specified for 
<appinfo> elements in the XSDL specification (see the W3C Web site at 
btip:/Avww.w3.org/?QV[L/Schema), these will simply be ignored by other XML 
schema processors that have not been designed to read them^ Table XI Usts properties 
10 that may be used: 



Table XI 


Property 


Description 


domainfield 


A Domain Policy attribute to map instances of this XML element 
or attribute to 


typemetadata 


A metadata type to map instances of this XML element or 
attribute 


converter 


A type converter for transfonnation of XML data values (strings) 
into typed values such as floating point numbers or date objects 


visible 


The initial visibility state wift which instances of this XML 
element or attribute should be e^qposed within an information 
element 


mutable 


Whether or not instances of this XML clement or attribute can be 
edited after being exposed within an infonnation element 
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Conversely, the system has the ability to construct an XML document and 
associated XML Schema from a hierarchy of information elements. The process for 
outputting an XML document and associated XML Schema from a hierarchy of 
information elraients is ^sentially the reverse of the ingestion process. The resulting 
5 schema documents are generated with the special <appinfo> instructions that carry the 
additional semantic meaning for the attributes, but (see above) these additional 
instructions are embedded in a way that makes them transparent to other XML 
document readers that do not recognize them. In this way, an application-to- 
agplication information communication session can be set up using HTTP or a similar 

10 protocol for synchronous communications, and SMTP or similar for asynchronous 
commxmications. The sending application encodes information elements into an 
XML schema/mstance pair using the just described apparatus and sends both to the 
receiver ^plication. The receiver reconstructs the information elements also using 
the above apparatus. Thus, any form of structured, annotated information that can be 

1 5 expressed within our framework can be transmitted between applications using a 
siinple document transfer protocol. Another embodiment of the present invention 
involves an apparatus 3020 , which will connect to a relational database system and 
extract or write information from it usmg the stmctured query language (SQL). The 
user of such an information source needs only to specify the tables and colimins to 

20 access within the database, as well as any selection criteria to naxrow the range of data 
retumedL The qjparatus performing this function will automatically convert the data 
in the database into the appropriate representational fom[iat and add metadata and 
parent-child links as required. In general, the process is similar to that described for 
the XML data input/output c^^ability, except ihat SQL statements and conversion 

25 mappings specified by flie user take the place of the XML schema and docum^t type 
and hierarchy information. 
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The process translates the result of a database query into an XIS data item, and 
each row in the result set is translated into a member data item of the result data item. 
Each row data item can also have a database query associated mfh it which can be 
executed to provide its own member data item. Access to the member items is on- 
5 demand (e.g., as called for by a consumer), an operation we refer to as "drill-down", - 
The row data items are created with attributes that are derived from the 
columns retumed by the result set. The attribute specifications can be generated 
automatically from the result set column SQL type specifications (integer, date, text, 
etc.), or can be customized to suit the needs of tiie user. The customization process 

10 allows the user to map database result colunm type definitions into more semantically 
rich domain policy and/or metadata-enhanced attributes that consumeis can take 
advantage of. In other words, the DSI can associate column data types with metadata 
types and domain policy attribute types. To do this the framework supports a number 
of attribute customization properties that the user can specify (described further 

15 below). 

Modifications to row data items are handled by allowing the user to associate 
parameterized update, insert and delete queries with a given result set When the 
value of a record member attribute is changed, the user specified parameterized query 
is executed, and the parameters are filled in from the attribute values identified in the 
20 query specification. Insertion and deletion ofrecord members are handled in a 
likewise manner. 

The following table. Table XII, describes the list of customizable properties 
supported by the SQL database interface process. These properties are used to 
describe a single interface to a database for producing one or more hierarchically 
25 organized information elements from its contend. 
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Table XII 


Property 


Description 


jdbcdiiver 


JDBC vendor driver class name 


idbc url 


JDBC database cniniiection URL 


display .name 


Defeult display name for result data item 




SlllT CpilPVi" cl'flt"**miaTI't' TOT* TTPCtll'l' t^CftSk ifl^TTI 


update.query 


Parameterized SQL update statement 




jvesuii. column names uiaL nu upuaie query paraineiers 




jraiauicicii£*eu o\^i~* luscri SLaieraeni 


■insert- columns 


Result columm names that fill insert auerv i^arameters 


delete.queiy 


Parameterized SQL delete statement 


delete.colurrms 


Result column names ihat fill delete query parameters 


drilldown.qiiery 


Parameterized SQL select statement for record drill- 
down 


drilldown-columns 


Result column names that fill drill-down query 
parameters 


result.attributes 


Result data item attribute names 


record-attributes 


Record data item attribute names 



The names of attributes listed for both result and record data items are used to 
uniquely identify the attributes. The customization of each attribute is done according 
5 to its unique name. The following table (Table XHI) describes the list of 

customizable properties that can be applied to each attribute, where <name> is the 
unique attribute name. Note the parallel between these properties and those given for 
the '<appinfo>* tag insertion in the case above of XML data parsing. 
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Table Xni 


Pronertv 


T)e s cH nti on 




The attribute disolav label 


<iia]ne>*dotaainfield 


A XIS Domain Policy class field to map this attribute 
to 


<naine>.typemetadata 


A XIS metadata class name to map this attribute to 


<nainOxonverter 


A XIS type converter for transformation of result 
values 


<name>.coliinms 


The result columns names that will be converted 


<name>*visifale 


The attribute initial visibility state 


<naine>.mutable 


The editability of the attribute 



Given the metadata from known industry standard APIs (e.g., JDBC and 
ODBC) that provide metadata for results (typically handled as tabular columns) 
including string, length, numeric predsion, date formatting, etc, relational databases 
may have dynanric DSI toolkit built and implemented as shown in Figure 27. Tabular 
data may also be interpreted as a defeult string typed. Java objects, remote Java 
objects (via RMI or CORBA-derived interfaces), and Enterprise JavaBeans (a variant 
of RMI objects) may have DSIs automatically created for them, using, for example, 
reflection and known types (primitives and other typical tjrpes like String, Data, etc., 
and registered typ^). A developer may also place XlS-specific annotations' (e-g., 
static AttributeDescriptor and FieldData methods) on reflected Java objects. 
Collection subclassed objects may also indicate containment. 

Dynamic data supplemental metadata may also be used in the XIS framework 
of the present invention. Schemas with little or no expressive information may also 
be used to specify additional metadata within the XIS framework, which include 
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mapping attributes to type metadata, mapping attributes or methods to domaijas, 
defining new attributes/methods based on existing data from the source, defining 
functions/user commands for easily implemented capabilities (e.g., deleting a data 
item, adding/inserting a new data item, initializing a template data item that a user can 
5 fill in before adding, etc.), and defining relationships to other data items to perform 
"drill-down" queries. Such type of schemas may be obtained, for example for Java 
Metadata API, CORBA API (on which the Java API was based), Oracle "common 
warehouse metamodel," and the like. Other formats for mapping metadata to schemas 
from other sources, or as might be defined in the future, may easily be incorporated 
10 within the firamework. 

Distributed Application Capabilities 

In an embodiment, the application development framework being discussed 
oflfers three sets of facilities to aid in the development of distributed applications in 
which users, software application conniponents, or both are distributed across multiple 
15 computers connected by a network. 

CORBA Ejqposure 

The first set of facilities allows the automatic exposure of a data source over a 
network to any remote consumer software object via the Common Object Request 
Broker Architecture (CORBA) protocol This protocol allows the remote consiraier to 
20 utilize information elements just as if they existed locally, but usually with lower 

bandwidth than it would take to send the entire elements over the network connection. 

To better understand the iavention, examples are shown below in Table XIV, 
which shows an exenoplazy XML document. 



Table Xrv • 


<tracks> 




<track name='Tmsr'> 
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<comitry>US</countiy> 
<categoiy>SUB<ycategory> 
<threat>HOS</threat> 
<position> 

<lat>10,0<yiat> 
<lon>10.0</lon> 
<alt>10.0</al1> 
</position> 
</track> 

<track name=**SECOND"> 
<coimtry>US</country> 
<category>AIR<categoiy> 
<threaP'FRI</threat> 
<positioji> 

<la^20.0</lat> 
<]on>20.0</lon> 
<alt>20.0</alt> 
<positicn> 
</track> 
</tracks> 



The following table (Table XV) shows the result if thp above XML document 
were run through an XML DSI. 

5 

TableXV 

LEDF Data Item - tracks 
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LEIF Data Item - track 

Attribute - name : String value='FIRST' 
Attribute - country : String value=='US' 
Attribute - category : String value='SUB' 
Attribute - threat : String value='HOS' 
LEIF Data Item - position : LEIF Data Item 
Attribute - lat : String value==*IO.O' 
Attribute - Ion : String valuer* 10.0' 
Attribute - alt : String value=' 10.0* 
LEIF Data Item - track 

Attribute - name : String value=*SECOM)' 
Attribute - country : String value='US' 
Attribute - category : String vatue=' AIR' 
Attribute - threat : String value='FRI' 
LEIF Data Item - position 

Attribute - lat : String value='20.0' 
Attribute - Ion : String value='20.0* 
Attribute - alt : String value='20.0' 



Table XVI below shows an exemplary XSDL document. 



Table XVI 
<?xml version="1.0" encoding="UnF-8^ 
<scheina xmlns='Tattpy/www.w3.org/1999/XMLSchema*'> 
<element name="tracks'*> 
<complexType> 

<elementname="track" type- Track" maxOccurs="unbounded"/> 
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</complexType> 

</eleiQent> 

<compIexType iiame="Track"> 

<attribute iiame="iiaine" type="string"/> 
<eleineiit name="coimtry" type="string"/> 
<eleinent name="category" typeF="string''> 
<eleinent name="threat" type=''string"/i> 
<element name="position" type='*LatLonAlt"> 

</complexType> 

<coinplexType name="LatLoiiAlt"> 
<element Tiame='1at" type=Mecimal*^/> 
<element name="lon" type="decimal"/> 
<element iiaine="alt" type=="decimal"/> 

</coEQplexType> 
<Vschema> 



XML Schema Definition Language ( jcsd) documents are used to express the 
semantic descriptions of Attributes and the Domains in which they Uve. Code 
5 generation utilities as described above create the actual Domain Objects with their 
groups of related Attributes. Thus, developers may create new Domains, and add 
Attributes to tibeir existing Domains, by modifying these XML Schema files and 
geaeratmg the appropriate Java code. XML Schema files include basic attribute 
constraints (e.g., value ranges, list of valid values, attribute naming, formatting, etc.) 
10 that are tamed into TypeMetaData objects, as well as textual conmients feat are 
converted into Java documentation to define the intent of the attribute (or method, in 
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the case of Domain methods). In some cases, Java code is embedded in tibie document 
and used inline in the generated Java classes for the Domain. 

Table XVTI below shows the result when the above XSDL document is used to 
type the elements in the XML document source. Note that the type for lat. Ion, and alt 
5 are now Double instead of String. 



Table XVn 

LEIF Data Item - tracks 
LEEF Data Item ~ track 

Attribute - name : String value='FIRST' 
Attribute - country : String value^'US* 
Attribute - category : String valu^*SUB' 
Attribute - threat : String value='HOS* 
LEEF Data Item - position 

Attribute - lat : Double value='10.0' 
Attribute - Ion ; Double vahie='10.0* 
Attribute - alt : Double yalue=*10.0' 
LEIF Data Item - track 

Attribute - name : String valu^'SECOND* 
Attribute - country : String valu^US' 
Attribute - category : String valu^* AIR' 
Attribute - threat ; String value='FRI* 
LEIF Data Item - position 

Attribute - lat : Double value«*20*0' 
Attribute - Ion : Double value=*20.0' 
Attribute - alt : Double value=^'20.0' 
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The following table (Table XVm) shows an exemplary XSLT document 



Table XVni 

<xsI:for-each 5elect="xsd:element"> 
<xsl:choose> 

<xsl: when test="@name=^ositiorf'*> 
<xsl:copy> 

<xsl:apply-teinplates select="@*"> 
<annotatioiP> 
<appinfo> 
<domaiQmap 

doinainfiel*==''comjds.domains.geo.GeoDcMnain.latLonAl 

converter="DegreesToLatLonAltConverter" 

parameteis="lat,lon,alt" 

label="Position" 

f> 

</annotation> 
</xsl:copy> 
</xsI:when> 
<xsl:otherwisc> 
<xsl:copy> 

<xsl:apply-templates select=^"@*"/> 
<xsl:copy> 
<xsl:otherwise> 
<xsl:clioose> 
</xsl:for-each> 
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When such a transfonnation is used with the previous XSDL source shown 
above, used to type the XML document source, the result is shown in Table XDC 
below. 



Table XDC 

LEIF Data Item - tracks 
LECF Data Item - track 

Attribute - name : String vaIue='FIRST' 
Attribute - country : String value='US* 
Attribute - category : String value^'SUB' 
Attribute - threat : String value^'HOS' 
Attribute - position : LafLonAIt <- now mapped to 

GeoDomainJatLonAlt 
LEIF Data Item - track 

Attribute - name : attribute value=='SECOND* 
Attribute - country : String value='US' 
Attribute - category : String value=' AIR* 
Attribute - threat : String value='FRI' 
Attribute - petition : LatLonAlt <- now mapped to 

GeoDomainJatLonAlt 



Note that position has been mapped to GeoDomainJatLonAlt, meaning, it is 
now a LatLcmAlt type. The lat, Ion, and alt attributes are still tiie same, but the 
position itself may now be dealt as a single LatLonAlt object rather than a generic 
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data item with three Double fields. The use of XSLT also enables the mappmg of 
XML elements into TypeMetaData, such as the LatLonAltTypeMetaData in order 
have better mampulatioii of the data. 

In one embodiment of the invention, the XIS framework has a "remote" 
5 capability mabling referral to an XIS session, or the data wthin it, from a remote 
virtual machine. Primarily, this means that data retrieval and sharing is the basis for 
export and collaboration. Secondarily, it supports operating on data within XIS from 
a remote virtual machine, perhaps on information existing only at that remote virtual 
machine, 

10 In another embodiment, SOAP (Simple Object Access Protocol) may be 

utilized. SOAP is a messaging framework that defines a protocol for the exchange of 
information in a decentralized, distributed environment. See, for example, the WSC 
Web site at http://www.w^3.org/TR/SOAP. SOAP provides an instantiation of the 
remote capability, and is used to enable a general-purpose means of mating together 

15 or commumcating among distributed sessions. These sessions may be two full XIS 
sessions on separate servers, or may comprise one XIS server and one XIS client, or 
may be used to interface XIS to otherwise very different software, even including 
software applications written in different programming languages and running on 
incompatible operating systems. All data and remote procedure calls are made 

20 through XML, TTiose skilled in the art will be understand that SOAP is an XML- 
based protocol. The working draft of this specification is currently being developed 
bytheWaC. 

In another embodiment, remote references are used. These references are 
persistable or persistent references to XIS data. In a distributed context XIS uses 
25 XML representations of the references to share, persist, or identify particular data. 
Boabedded in the XML are custom information enabling determination of data 
location in files or databases, on web servers, or based on unique Ids or names witiliin 
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the XIS session, or based on data which are passed to a constructor, or on an ECMA 
script that can re-generate the data object. 

In another embodiment, the data representation in the remote distributed 
sessions is all based on the XIS mediation layer. All data, regardless of the initial 
5 type, is.passed and manipulated as sets of attributes and relationships. This greatly 
enhances portability and interoperability of the data. At the same time the data 
contains a global unique identifier, so the individual and specific source and identity 
of that data is maintained in spite of having been translated to a mediated format 
In another embodiment, a metadata type, e.g., "Constructor Scripts," is used 

10 This metadata type supports the generation of ECMA Script scripts to restore a 
TypeMetaData (metadata type) object at a later time. By executing the script, the 
TypeMetaData is restored to its exact state. The advantage over standard Java object 
serialization is con trol over the save/restore process, and the ability to represent the 
state in fairly readable text format. 

15 Distributed Multi-user Collaboration 

Figure 31 is a sdiematic diagram of the second set of facilities that allows 
users at remote computers to collaborate through shared views of the same data. It 
also shows objects and methods that may be involved in distributed collaboration 
facilities. Visual consumer components (e.g., INFOBEANs) are condensed and 

20 compressed so that they may be efficiently accessed by a remote computer and then 
locally displayed. This is done using a MetaView object, which encapsulates the 
essential elements of a visual component to allow reconstruction on another screen 
with minimum requixement for data transmission. MetaViews are manipulated using 
the relationship handling machinery of the firamework as discussed above; in 

25 particular, an indirect reference to the MetaView is produced and passed around to 
remote consumers, who need only resolve the reference and retrieve the MetaView 
object if the user requests the display. 
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An event-handling schema is introduced for transmission of changes in the 
view firom one computer to all others "fiiat are joined to the session. View 
management is accomplished via a "tree" display showing hierarchies of local views, 
sessions, and shared views (including properties and subsidiary data items). Views 
5 may be shared through the intuitive action of dragging and dropping them from one 
branch on the tree to another. Multicast protocols may be used so that MetaViews, 
LeifReferences (references), and Event objects may be transmitted directly from one 
computer to another without the need to go through a server. Alternatively, HTTP 
protocols may be employed if security and firewall considerations make multicasting 
10 impractical. 

Metadata Server Facilities 

Figure 32 shows a third set of facilities that allows remote consumer software 
objects 3220 to obtain additional annotations on information that is encountered along 
with at least a minimal self-description component, as may be found, e.g., in an XML 

15 tag name. These facilities are targeted to be useful to software agents 3202 in 
particular. (See Wooldridge, M., Jennings, N. (1995); "Intelligent Agents; Theory 
and Practice" in Knowledge Engineering Review 10:2,) For example, a Java software 
agent may occasionally encounter data objects or request terms, which were not 
anticipated when flie agent was programmed. The tag name or other descriptive 

20 annotation (connector) 3206 is used as a key to request metadata and possibly domain 
poUcy methods defined within XIS from a known server, called a sernantic repository 
3204. The server 3204 checks its index for a match; if a match is not found, it can 
optionally ask a predicate logic inference engine 3208 to provide alternate names to 
search under (e.g., "cat, large, ferocious" is returned from the inference engine in 

25 response to a request for *Tian"), which are then also conrpared to the index. If a 
match is found, the server returns the appropriate metadata and possibly domain 
policy method(s) to the requesting agent 3202, making use of either Sun's Jini 
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framework or Java's built-in provisions 3222 for network transfer and subsequent 
dynamic loading of classes (including, e.g., procedural components of the metadata 
and methods) to transfer the actual code procedures into the running agent. These 
transferred information can then be used by the agent 3202 to aid in handling the 
5 object. For example, an agent can display an unanticipated data type to a user by 
calling the renderer method thus returned from the semantic repository. The semantic 
repository may also interface with other repositories 3212 via a data network 3210, 
such as a wide area network (WAN) 3210. 

In the above embodiment, information metadata and even information access 
10 software may be dynamically downloaded from remote sources ("semantic 

repositories" or "Metadata Server Facilities"), e.g., from the data source itself or from 
an intermediary server. This is a unique feature particularly as applied to XIS 
metadata, domain policies, and DSIs. 

One skilled in the art will ftnrflier imderstand that the common representation of 
15 and access to information from internal APIs (mediation layer) may be exported to 
distributed application in support of middleware architectures for scalability or other 
advantages, and in support of collaboration by sharing data and data changes 
(permanent or transient) with other distributed collaborators. 

The present invention also supports user "transfer" of objects from one context 
20 (e.g., between two INFOBEANs) via drag/drop, cut/paste, and other mechanisms- 
Transfers of objects apply only to non-contextual information. Thus, each view has 
its own InfoModel that i)rovides the contextual information for that view alone. 
Example S below further explains this idea. 
Example 5 

25 The Example S application is contained in three Java source files, 

HelloWorldjava, HelloWorldTranslator java, and TestHamess.java. The source files 
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for this Example are explained below. The resulting outputs are shown in Figures 
38A and 38B. Non-contextual infonnation is transferred in this Example, 

The Java source files in Example 5 modify those from Example 3 or 4 to 
demonstrate the use of drag and drop facilities within XIS, along with a more 
5 complex view. As before, changes from the previous step are marked by open and 
close commented braces. 

The table below (Table XX) shows a code snippet that replaces a portion of 
code in the Hello World.java file shown in Example 3. The code portion below 
replaces the portion of code 2102 found in Figure 21 to implement Example 5. 

10 

Table XX 

/*{*/ 

private String myNarae; 
public HelloWorld(StringmyName) { 
this,myName - myName; 

} 

public String toStringQ { 
return myName; 

} 

/*}*/ 



With the above modification, the HelloWotldjava file for this Example has 
been enhanced so that instances can be given names upon creation^ and this name is 
15 returned by the toStringQ method. Also, the getTDQ me&od has been removed. 
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The HelloWorldTraBslator.java file for this Example is similar to the 
HelloWorldTranslator.java file shown in Figures 22A to 22C, except that this source 
file has been simplified from the previous version by removing the ^'course" attribute. 
Figures 37A to 37D list the TestHamess.java source file, where the bulk of the 
5 changes are coded. First of all, it contains an import to help lay out multiple 

components within a Jfirame 3702, and also imports for two new XIS INFOBEANs: a 
Table bean and a Tree bean 3704. The tree bean displays data items and any member 
data items they contain, and enables users to select and perform various fimctions on 
' them such as editing their properties. The table bean displays the attributes of 
10 multiple data items in a user-configurable way. 

The fibrst portion of new code 3706A and 3706B initializes several HelloWorid 
objects and inserts them into an array. The table and plot INFOBEANs are initialized 
and placed side-by-side in a JFrame. They are not loaded with any data items, but 
items can be dragged onto them when the application is running. The next thing is 
15 that a tree INFOBE AN is initialized and loaded with the array, and it is put up in its 
own JFrame. 

This Example 5 application puts up two windows-the first is a Tree 
INFOBEAN containing several HelloWorid data items. The second has two firames, 
on the left a Table INFOBEAN, on the right a Cbzxt INFOBEAN, both of which are 

20 initially empty. The table is initially completely blank because it has no information 
on what headings are appropriate, while the plot displays a defeult grid. 

In the tree display, a user may select data items or open and close fliem, similar 
to the directoiry tree view provided by the "Windows Explorer" application. In tins 
case, the only item that contains anything is the root, which is a special data item. 

25 Double-clicking on it opens or closes it, but it caimot itself be selected. Right clicking 
on an item (but not the root) brings up a menu of q)erations that may be performed on 
it In particular, selecting Troperties* brings up a property sheet. window (as in tiie 
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previous examples) for that particular instance. A user may left-click-and-drag on 
data items from the property sheet window over to tiie table or the plot 

The table automatically sets up columns for the preferred attributes of the data 
items dragged onto it. The layout may be changed mteractively by either dragging on 

5 the headings or &eir boundaries, or by right clicking on the headings. Double 

clicking on the attributes enables a user to edit Hiem. Items may also be dragged from 
the table onto the plot as well, or in the other direction. The selection and pen color 
attributes are kept aligned automatically between all views of the same data item. A 
user exits the application by closing the tree wmdow. 

10 Data item commands, also known as JAF Commands (based on "JavaBeans 

Activation Framework") may also be implemented within XIS. The JAF API is a part 
of Java and provides a way to associate commands with object. By using JAF, 
developers may take advantage of standard Java interfaces to determine die type of an 
artitraiy piece of data, encapsulate access to it, discover the operations available for it, 

15 and to instantiate the sqDpropriate bean to perform said operation(s). For example, if a 
browser obtained a JPEG image, JAF would enable the browser to identify that the 
stream of data is a JPEG image, and from that type, the browser could locate and 
instantiate an object that could manipulate, or view that image. JAF commands are 
typically used in pop-up menus or menu bars to control objects. 

20 XIS uses JAF commands to control DSIs and perform operation on data items. 

Right clicking on a data item in an InfoBean pops up a menu with commands that are 
specific to that data item. JAF commands with XIS may implement the following: 

- "Context Menus" or pop-up menus initiated by right clicking on a 
25 display that represents one (or more) data items; 
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- Command "menus" may be combined into a menu for multiple objects 

(e.g., one single command (menu item) to delete all selected 
objects; 

- Addition of data item commands per object type by adding them to the 

"JAF" registry; 

- Addition of file/content MIME types in the display; 

- Addition to the "JAF" registry of entries that represent objects that can 

add any number of menu items dynamically; 

- JAF commands may be added by 'Menu Populators" that can add 

menu items for single and multiple data items; 

- JAF commands may be added by the environment for other typical 

functions that nright be performed on any object (possibly 
depending on capabilities/content of that data item), e.g., 
Copy/Paste/Cut/Delete, ffide/Show, Refers To (if the object 
exposed relationships to other objects which may or may not be 
loaded yet), Contains, Referred by. Contained by, URLs 
(attributes). Properties, etc.; and 

- Default behavior of "Properties" command may be overridden using a 

"JAF entry." 

Figures 38A, 38B> 38C, and 38D show how JAF is used within the framework. 
Figure 38A shows a menu of HeUoWorld objects for selection, displayed on a screen 
of the computer system implementing the framework. Figure 38B shows that the 
HelloWorld objects are displayed through a graphing (data plot) viewer. Figure 38C 
shows flie display of Figure 38B after the display cursor has been positioned over the 
bar graph, followed by a rightHjlicL A context maan, enabling the user to select the 
"Properties" option, is displayed in Figure 38D. In this example, the HelloWorld 
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object can be manipulated by a PropertySheetlnfoBean object Thus, selecting the 
"Properties" option results in a PropertySheetlnfoBean being instantiated showing the 
properties of the First HelloWorld object, as shown in Figure 38D. 

Another feature provided by the XIS framework is the use of attribute ahases. 
5 This enables one attribute from one domain to be substituted for an attribute in 
another domain. For illustration purposes, let us assume that we have two domains 
called Movement Domain and Physics Domain. The attribute speed in knots is 
defined in the Movement Domain, while the attribute velocity in meters/sec is defined 
in the Physics Domain. The XIS framework enables a developer to register or define 
10 that the speed attribute in the Movement Domain is similar or compatible with the 
velocity attribute in the Physics Domain. Thus, enabling a data consumer object to 
ask for the Attribute from the domain that it knows about, and have the value 
translated from the Attribute of the DSI fix>m the second domain. 

Figure 39A, 39B, and 39C show details of an exemplary embodiment 
15 e^^laining how an interface for the attribute alias feature described above may be 
defined or implemented within the XIS framework. The illustration includes class 
listing for objects that are used in the preferred embodiment of the framework. 

Figure 40 is a block diagram of a computer that may be used to implement tiie 
framework described herein. The fi^maework may be used m a single computer, or 
20 may be used in conjunction with one or more computers that may commxmicate with 
each other over a network to share data. Those skilled in the art will appreciate tiiat 
the various data objects, framewodc extensions, and other processes described above 
may be implemented with one or more computers, all of which may have a similar 
^ ccmputer construction to that illstrated in Figure 40, or may have alternative 

25 constructions consistent with the capabilities described herein. 

Figure 40 shows an exemplary computer 4000 such as might comprise a 
computer in whidi an object oriented programming environment is supported to 
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pennit the firamework operations described above, and to pennit ttie various display 
operations and computer processing events. Each computer 4000 operates under 
control of a central processor unit (CPU) 4002, such as a "Pentium" microprocessor 
and associated integrated circuit chips, available from Intel Corporation of Santa 
5 Clara, California, USA, A computer user can input commands and data from a 
keyboard and computer moxise 4004, and can view inputs and computer output at a 
display 4006. The display is typically a video monitor or flat panel display. The 
computer 4000 also includes a direct access storage device (DASD) 4008, such as a 
hard disk drive. The memory 4010 typically comprises volatile semiconductor 

10 random access memory (RAM). Each computer preferably includes a program 

product reader 4012 that accepts a program product storage device 4014, from which 
the program product reader can read data (and to which it can optionally write data). 
The program product reader can comprise, for example, a disk drive, and the program 
product storage device can comprise removable storage media such as a magnetic 

15 floppy disk, a CD-R disc, a CD-RW disc, or DVD disc. 

The computer 4000 can communicate with other computers over a computer 
network 4016 (such as the Internet or an intranet) through a network interface 401 8 
that enables communication over a connection 4020 between (he network 4016 and 
the computer 4000. The network interface 4018 typically comprises, for example, a 

20 Network Interface Card (NIC) or a modem that permits commxinications over a 
variety of networks. 

The CPU 4002 operates under control of programming steps that are 
temporarily stored in the memory 4010 of the computer 4000, When the 
programming steps are executed, the computer performs its functions. Thus, liie 

25 programming steps implement the functionality of the event tracking process 
described above. The programming steps can be received from the DASD 4008, 
through the program product storage device 4014, or through the network connection 
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4020. The program product storage drive 4012 can receive a program product 4014, 
read programming steps recorded thereon, and transfer the programming steps into the 
memory 4010 for execution by the CPU 4002. As noted above, the program product 
storage device can comprise any one of multiple removable media having recorded 
computer-readable instructions, including magnetic floppy disks and CD-ROM 
storage discs. Otifcier suitable program product storage devices can include magnetic 
tape and semiconductor memory chips. In this way, the processing steps necessary 
for operation in accordance with the invention can be embodied on a program 
product. 

Alternatively, the program steps can be received into the operating memory 
401 0 over the network 401 6. In the network method, the computer receives data 
including program steps into the memory 4010 through the network interface 4018 
after network communication has been established over the network connection 4020 
by well-known methods that will be understood by those skilled in the art without 
further explanation. Hie program steps are then executed by the CPU 4002 thereby 
• comprising a computer process. 

It should be understood that the any device that supports the framework 
envimomnent described above, acting as a host computer, will typically have a 
construction similar to that shown in Figure 40, so that details described with respect 
to the Figure 40 computer 4000 will be understood to apply to all computers of any 
network system in which the framework or framework-developed applications are 
utilized. Alternatively, the devices can have an alternative construction, so long as the 
computer can conmnmicate with the other computers and can support tibe 
fbnotionality described herein. 

All patents, patent applications, publicatioos and references mentioned in the 
specification are indicative of the practice level of those skilled in the art to which the 
invention p^tains. All patents, patent ^plications, publications and references are 
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herein incorporated by reference to the same extent as if each individual patent, patent 
application, publication or reference was specifically and individually indicated to be 
incorporated by reference. 

One skilled in the art should readily appreciate that the present invention is 
well adapted to carry out the objects and obtain the ends and advantages mentioned, 
as well as those inherent therein. The specific embodiments described herein as 
presently representative, of preferred embodiments are exemplary and are not intended 
as limitations on the scope of die invention. C3ianges therein and other uses will 
occur to those skilled in the art which are encompassed within the spirit of the 
invention are defined by the scope of the claims. It will be readily apparent to one 
skilled in the art that modifications may be made to the invention disclosed herein 
wifbout departing from the scope and spirit of the invention. 

The present invention has been described above in terms of presently preferred 
embodiments so that an understanding of the present invention can be conveyed. 
There are, however, many configurations for information system firameworks not 
specifically described herein but with which the present mvention is applicable- The 
preset invention should tiherefore not be seen as limited to flie particular 
embodiments described herein, but rather, it should be understood that the present 
invention has wide applicability with respect to information systems generaDy. All 
modifications, variations, or equivalent arrangements and implementations that are 
within the scope of the attached claims should therefore be considered within the 
scope of the invention. 
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CLAIMS 

We claim: 

5 

1 , An extensible framework for use in a computer system that supports an 
object oriented programming environment and includes a memory in which data 
objects can be stored, the framework comprising a set of object classes that can be 
extended using object oriented principles to define an information handling 

10 application with data objects coniprising a class of data source objects and a class of 
data consumer objects, and a mediation layer that defines an interface between the 
data source objects and the data consumer objects to permit data commtmications 
between &e two data object classes, such that the class configuration of the data 
source objects can be specified independently of the class configuration of the data 

15 consumer objects. 

2. A computer system that supports an object oriented jsrogramming 
environment and includes access to data storage containing specifications for a set of 
object classes that can be extended using object oriented principles to define an 

20 infonnation handhng application with data objects comprising a class of data source 
objects and a class of data consumer objects, and a mediation layer that defines an 
interface between the data source objects and the data consumer objects to permit data 
information exchange between the two data object classes, such that the class 
configuration of &e data source objects can be specified independently of the class 

25 configuration of the data consumer objects. 
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' 3. A computer system as defined in claim 2, wherein the raediation layer 
dejSnes a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

5 4. A computer system as defined in claim 3, wherein the data interface 

includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declarative and procedural information relating to 
attributes in said data object 

10 5. A computer system as defined in claim 3, wherein the data interface 

includes at least one Relationship object class that specifies relationships between 
data source class objects. 

6. A computer system as defined in claim 3, wherein the data interface 
15 includes at least one Domain PoKcy object class that specifies a group of related 

attributes, methods, and semantic information that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

7. A computer system as defined in claim 3, wherein the data interface 
20 includes at least one Event Change object class that specifies change event 

registration for detecting changes in the data objects. 

8. A conq)uter system as defined in claim 4, fiirttier including a 
TypeMetaData class of objects that specify semantic information indicating data 

25 processing to be available for specified attributes and intended use of the attributes of 
a data object. 
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9. A computer system as defined in claim 8, further including a TypelO 
class of objects that define a desired format of a data object attribute specified by a 
TypeMetaData class. 

5 10. A computer system as defined in claim 6, wherein an attribute alias may 

be specified by a user to indicate any data source attributes of an attribute domain fliat 
may be substituted with attributes of a different attribute domain. 

11. A computer system as defined in claim 4, wherein said 

10 attribute/metadata interface provides input/output Sanctions for display and editing of 
the attribute during runtime. 

12. A computer system as defined in claim 4, furdiCT including a 
FieldMetaData attribute that specifies processing criteria for an attribute of a data 

15 object 

13. A computer system as defined in claim 4, wherein the processing 
oiteria relates to a selected attribute of the data object for display processing. 

20 14. A computer system as defined in claim 5, wherein the indicated 

relationship may be resolved using a version of the Relationship object in cache of the 
computer system. 

15. A computer system as defined in claim 2, fiirfher including a 
25 collaboration facility that permits a user at a network computer remote from the 
computer system to share a view of a data object at the remote network computer. 
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16. A computer system as defmed in claim 15, wherein the cbllaboratioii 
facility comprises a MetaView class of data objects that lightweight encapsulate 
elements of a data object for visual reconstruction on a display screen of the remote 
network computer. 

5 

17. A computer system as defined in claim 4, wherein the data interfece 
provides an override function that can override default metadata of the data object 
attributes. 

10 18. A computer system as defined in claim 6, wherein the data interface 

provides an override fimction that can override default metadata of the data object 
attributes. 

19. A con5>uter system as defined in claim 3, wherein data objects provided 
15 through the data interface conqjrise information that specifies data attributes, 

relationships, event broadcasting of changes in all registered data consumer objects, 
metadata for attributes that provide declarative and procedural infonnation and/or 
input/output fimctions for display and editing, and related data items, and wherein the 
data objects can store references without direct access to a related data item* 

20 

20, A computer system as defined in claim 19, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

25 21. A computer system as defined in claim 3, wherein the mediation layer 

fiarther includes object classes that include one or more methods that provide data 
es^sure, and further including a Data Source Interface object class of data objects 
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with methods that automatically determine which data exposure method will be used 
for data commurdcatiQns between the data source objects and data consumer objects. 

22. A computer system as defined in claim 21 , wherein the detennined data 
5 exposure method comprises data object reflection and introspection. 

23. A computer system as defined in claim 21, wherein the data exposure 
methods include a data source object method that provides a standard interface, a data 
source object and a Translator object that maps an alternate data interface to the 

10 standard interface, and a data source object that is inspected by the computer system 
to detemrine available data fields which are thereby exposed to data consumer objects 
by the standard interfece. 

24. A conaputer system as defined in claim 3, wherein the data interface of 
15 the mediation layer provides a wrapper for the data objects. 

25. A conaputer system as defined in claim 24, wherein data exchange 
occurs without providing contextual data characteristics to a receiving data object. 

20 26. A computer system as defined in claim 25, wherein the contextual data 

characteristics are supplied by the data object wrapper. 

27. A computer system as defined in claim 3, wherein data exchange occurs 
without providing contextual data characteristics to a receiving data object 

25 

28. A computer system as defined in claim 2, further including a plug-in 
manager object class that integrates service components into the application. 
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29. A computer system as defined in claim 28, wherein data service 
components interact with other components of the application to determine if a 
service is required and to deteraiine parameters that are to be interchanged 

5 

30. A computer system as defined in claim 29, wherein the service 
detemiination. occurs upon introduction of newly loaded components. 

31. A computer system as defined in claim 3, furfeer including a translator 
10 facility that translates information concerning a data object into (1) attributes and 

metadata that deiSne groiqjs of data source and data consumer class attributes and (2) 
an object class that specifies at least one domain method for defining groups of data 
object attributes. 

15 32. A computer system as defined in claim 24, further including an 

InfoModel data object class. 

33, A computer system as defined in claim 27, wherein said contextual data 
characteristics are supplied by an InfoModel object 

20 ■ 

34. A computer system as defined in claim 33, wherein the InfoModel 
object receives a data source object for exposure to the data consumer objects, selects 
available attributes and methods of the received data source object for data 
characterization, and determines if the addition of attributes or methods to the data 

25 source object are appropriate. 
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35. A computer system as dejBned in claim 6, wherein the domain is defined 
using XML schema* 

36. A method of communicating data in a computer system that supports an 
5 object oriented programming environment and includes data storage or access to data 

storage containing data objects and specifications for a set of object classes that can 
be extended using object oriented principles to define an information handling 
application, the method comprising: 

receiving one or more data objects comprising a class of data source objects; 
10 representing the data source objects in accordance with an Information Model 

class of objects of a mediation layer that defines a data interface between the data 
. source objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
communications or information exchange between the two data object classes, such 
15 that the class configuration of the data source objects can be specified independently 
of the class configuration of the data consumer objects. 

37. A method as defined in claim 36, fiirther including specifying at least 
one attribute/metadata object class that specifies attributes, including metadata, and 

20 that provides declarative and procedural information relating to attributes in said data 
object 

38 A method as defined in claim 36, fiirther including specifying a 
Relationship object class or classes that specify relationships between data soxuce 
25 objects. 
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39> A method as defined in claim 36, further including specifying a Domain 
Policy or Domain object class or classes that specify a group of related attributes, 
methods, and semantic information that indicates data processing to be available for 
the specified attributes^ including the specific intent of said attributes. 

5 

40. A method as defined in claim 36, further including specifymg an Event 
Change object class or classes that specify change event registration for detecting 
changes in the data objects. 

10 41 . A method as defined in claim 37, further including specifymg a 

TypeMbtaData class of objects that specify semantic information indicating data 
processing to be available for specified attributes and intended use of the attributes of 
a data object. 



15 42. A method as defined in claim 41 , further including specifying a TypelO 

class of objects tiiat define a desired format of a data object attribute specified by a 
TypeMetaData class. 



43. A method as defined in claim 39, further including specifying an 

20 attribute alias by a user to indicate any data source attributes of an attribute domain 
that may be srubtitued with attributes of a different attribute domain. 

44. A mefiiod as defined in claim 37, wherein the attribute/metadata 
interface provides input/output functions for display and editing of the attribute during 

2S runtime. 
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45. A method as defined in claim 37, wherein the attribute/metadata object 
class is a FieldMetaData attribute that specifies processing criteria for an attribute of a 
data object. 

46. A method as defined in claim 37, wherein the processing criteria relates 
to a selected attribute of the data object for display processing. 

47. A method as defined in claim 38, wherein the indicated relationship 
may be resolved using a version of the Relationship object in cache of the computer 
system. 

48. A method as defined in claim 36, further including providing a 
collaboration facility that pennits a user at a nework computer remote fixim the 
computer system to share a view of a data object at the remote network computer. 

49. A method as defined in claim 48, wherein the collaboration facility 
comprises a MetaView class of data objects that lightweight encapsulate elements of a 
data object for visual reconstruction on a display screra of the remote network 
computer. 

50. A method as defined in claim 37, wherein the data interface provides an 
override fimction that can override default metadata of the data object attributes. 

51. A method as defined in claim 39, wherdn the data interfece provides an 
override fimction that can override de&ult metadata of the data object attributes* 
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52. A method as defined in claim 36, wherein data objects provided through 
the data interface comprise infonnation that specifies data attributes, relationships, 
event broadcasting of changes in all registered data consumer objects, metadata for 
attributes tiiat provide declarative and procedural infonnation and/or input/output 
iunctions for display and editing, and related data items, and wherein the data objects 
can store references without direct access to a related data item. 

53. A method as defined in claim 52, wherein the attributes and 
relationships include contextual metadata, and the events and methods are defined 
with respect to the contextual metadata. 

54. A method as defined in claim 36, wherein the mediation layer fiirther 
includes object classes that include one or more methods that provide data exposure, 
and fiirther including a Data Source Interface object class of data objects with 
methods that automatically determine which data exposure method will be used for 
data commimications between the data source objects and data consumer objects. 

55. A method as defined in claim 54, wherein the determined data e^qwsure 
method comprises data object reflection and introspection. 

56. A method as defined in claim 54, wherein the data exposure methods 
include a data source object method tfiat provides a standard interface, a data source 
object and a Translator object that maps an altemate data interface to the standard 
interface, and a data source object that is inspected by the computer system to 
determine available data fields which are thereby e?q>osed to data consumer objects by 
Ihe standard interface. 



115 



wo 02/46916 



PCT/USOl/48418 



57. A method as defined in claim 36, wherein the data interface of the 
mediation layer provides a wrapper for the data objects. 

58. A method as defined in claim 57, wherein data exchange occurs without 
5 providing contextual data characteristics to a receiving data object 

59. A mettiod as defined in claim 58, wherein the contextual data 
characteristics are supplied by the data object wrapper. 

10 60. A method as defined in claim 36, wherein data exchange occurs without 

providing contextual data characteristics to a receiving data object 

61 - A method as defined in claim 36, further including a plug-in manager 
object class that integrates service components into the ^pUcation. 

15 • 

62. A method as defined in claim 6 1 , wherein data service components 
interact with other components of the application to determine if a service is required 
and to detomine parameters that are to be interchanged. 

20 63. A method as defined in claim 62, wherein the service determination 

occurs upon introduction of newly loaded components, 

64, A method as defined in claim 36 , fiurther including a translator fecility 
that translates information concerning a data object into (1) attributes and metadata 
25 that define groups of data source and data consumer class attributes and (2) an object 
class ttiat specifies at least one domain method for defining groups of data object 
attributes. 
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65. A method as defined in claim 57, fiirfher including an InfoModel data 
object class. 

5 66. A method as defined in claim 60, wherein said contextual data 

characteristics are supplied by an InfoModel object. 

67. A method as defined in claim 66, wherein the InfoModel object receives 
a data source object for exposure to the data consumer objects, selects available 

10 attributes and methods of the received data source object for data characterization, 
and determines if the addition of attributes or methods to the data source object are 
appropriate. 

68. A method as defined in claim 39, wherein the domain is defined using 
15 XML schema. 

69. A computer system that supports an object oriented programming 
environment, the system comprising: 

*a processor that executes program instructions to provide the object oriented 
20 programming enviromnent; and 

data store means for providing program instmctions containing specifications 
for a set of object classes that can be extended using object oriented principles to 
define an information handling application with data objects comprising a class of 
data source objects and a class of data consumer objects, and a mediation layer tiiat 
25 defines an inteiface between the data source objects and the data consumer objects to 
permit data information exchange between the two data object classes, such that the 
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class configuration of the data source objects can be specified independently of tiie 
class configuration of the data consumer objects, 

70. A computer system as defined in claim 69, wherein the mediation layer 
defines a data interface that provides an information exchange standard between the 
data source objects and the data consumer objects. 

71. A computer system as defined in claim 70, wherein the data mterface 
includes at least one attribute/metadata object class that specifies attributes, including 
metadata, and that provide declaxative and procedural information relating to 
attributes in said data object. 

72. A computer system as defined in claim 70, wherein the data interface 
includes at least one Relationship object class that specifies relationships between 
data source class objects. 

73. A computer system as defined in claim 70, wherein the data interface 
includes at least one Domain Policy object class that specifies a group of related 
attributes, methods, and semantic inforaiation that indicates data processing to be 
available for the specified attributes, including the specific intent of said attributes. 

74. A computer system as defined in claim 70, wherein the data interface 
includes at least one Event Change object class that specifies change event 
registration for detecting changes in the data objects. 

75. A program product for use in a computer systrai that executes program 
instmctians recorded in a cornputer-readable media to perform a method for 
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information exchange in a computer system that supports an object oriented 
programming enviroimaent and includes access to data storage containing data 
objects, the program product comprising: 

a recordable media; and 
5 a program product of computer-readable instructions executable by the 

compute system to perform a method comprising: 

receiving data specifications for a set of object classes that can be extended 
using object oriented principles to define an information handling application, 
wherein the extended objects provide an informatioB handling application that can 
10 receive one or more data objects comprising a class of data source objects, and 

represent the data source objects in accordance witii an Information Model class of 
objects of a mediation layer that defines a data interface between the data source 
objects and a class of data consumer objects; 

wherein the Information Model objects include methods that permit data 
15 communications or information exchange between the two data object classes, such 
that the class configuration of the data source objects can be specified ind^endently 
of the class configuration of the data consumer objects. 

76. A program product as defined in claim 75, wherein the method fiirflier 
20 includes specifying at least one attribute/metadata object class that specifies attributes, 

including metadata, and that provides declarative and procedural information relating 
to attributes in said data object 

77, A program product as defined in claim 75, wherein the method fijrfher 
25 includes specifying a Relationship object class or classes that spedfy relationshq>s 

between data source objects. 
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78. A program product as defined in claim 75, wherein the mefhod further 
includes specifying a Domain Policy or Domain object class or classes that specify a 
group of related attributes^ methods, and semantic information that indicates data 
processing to be available for the specified attributes, including the specific intent of 
said attributes, 

79. A program product as defined in claim 75, fiirther including specifying 
an Event Change object class or classes that specify change event registration for 
detecting changes in the data objects. 

80. A method of operating a computer system to execute an information 
handling application in an object oriented programming environment and to receive 
data from a class of data source objects and provide a class of data consumer objects 
with data, the method comprising: 

selecting available attributes and methods of a data source object for 
characterization; 

determining attribute or methods to be added to the data source object during 
application execution; and 

receiving the data source object and determining whether to expose or hide 
available attributes and methods of tibte object from data consumer objects, wherein 
data communications between the two data object classes is supported, such that the 
class configuration of the data source objects can be specified independently of the 
class configuration of the data consume objects. 



120 



wo 02/46916 



1/90 



PCT/USOl/48418 



^-100 

r 




Figure 1 



wo 02/46916 



2/90 



PCT/US01/4841S 




Figure 2 



wo 02/46916 



3/90 



PCT/US01/4S418 



0) 

(ft 
c 



05 ? S 



-S 5 -2 ° ® "B, o S ^ 

5 S EC 5 O H 
O « • * • n 




U 

CO 



c c ^ 



9 .B- 

03. CO 
CD « 



3 

-2 ^ 



c: 

3 

o 
u 

S5 =- 

I? X : 
* *- I 



■^2 o c = . 

O (C p • 

t— ^ ^ liL 

^ 2 S o ^ 

^ 2 £ c £ 

^ GL Q. c& Q. 



to 

CD P 



2 8 

r5 O < 
c> "S 



< b_ Q 2 
ft • « • 



o 



o 



2 
TS 

G 



o 

0.1 

O 



o ./. o 



CO o . ~ 
'7* c; ^ CD 

o. ♦ » » 




T 




o 




p 


"5 


3 




Q 






3 






E' 






o 


O 




75 






Q 


o 





wo 02/46916 



4/90 



PCTAJSOl/48418 




So 

ni C 



o 
c 

(U 

'J 

to 

o 

§ 

c 



CO qj* 0? 

o q5 "flo 



e 

^ o 

c -J a GO > 

"a CI 0\ 



2i O 



2 S 
c O 

> > 



CO 

is 






wo 02/46916 



5/90 



PCT/US01/4841S 



100 




Domain 470 



Relationship 472 



Attribute 474- 



Identity 476 



Name 478 



Value 480 



Type Metadata 482 



Description 484 



r 



460 



Data 

Source 
Interface 
(DSI) object 
412 



Data 
Source 
interface 
(DSI) object 
414 




Relationship 473 



Attribute 475 



identity 477 



Name 479 



Value 481 



Type IVIetadata 483 
Description 485 



Figure 4 



wo 02/46916 



6/90 



PCT/USOl/48418 




Attribute 
530 



Attribute 

Descriptor 
532 



wo 02/46916 



7/90 



PCT/USOl/48418 



Figure 6A 



} :£|)B- J Ecfii Selecl^n jgaw ' . Fayoritas * Tools :'Map /Wlndcw- Melp 





.0 












{^nter |DO:09:31S^OW8:41E -^[r.- fvyMth: jl4.4t36.714 ..[NM jJ(E(iulcii5tenc 


3 - 



wo 02/46916 



mo 



PCT/USOl/48418 



Figure 6B 
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Figure 7 
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Figure 9 
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Package com.xis.types 

This package contains classes that provide several standard TypeMetaData classes for describing types and their 
constraints, and for rendering and editing values of chose types. 



See: 

D cscriptton 



Interface Summary 




The DataTest incer&ce specines methods for Object validation. 




This interface defines the 10 for HTML. 


Summary Fitnciwn 


The Suinmaryr unction' interface defines generic summary functionality based upon provided 

input data values. 


Sivm^TypefO 


The SwingTypelO interface allows for the use of both swing editors, allowing swing 
components to edit an object, and swing renderers, which know how to render these objects in 
a swing environment. 




The TextTypelO interface provides a means of formatting objects in a textual &shion, as well 
as parsing text from which an object is created. 


Tvped^alut 


it. 


Tvpe Editor 


The TypeEdi tor interface defines methods for editing attributes provided by the types 
implemented within this package. ' * ' 




The TypelO interface provides a common base from which other TypelOs can extend, such as 
HTMLTypeIO^ SwingtypelO, etc. 


TypeMetaData 


The TypeMetaData interfece defines generic type accessors for object comparing, editing, 

formatting, rendering, and validation. - 


TypeMetaData Factory 


The TypeMetaOataf actory interface defines a class that caq create TypeMetaData for a . 
given Class Type. « . 


TvpeHenderer 


The TypeRendecar interface defines methods for i;endering attributes provided by the types 
implemented within this package. 


yafttrre^tPrpxy 


The ValidTestProxy interface 


WMLTvpeEdhor 


The VfMLTypeSdvtor interface defines methods for rendering attributes provided by the types 
implemented within this package. 


IVMLTypefO 


Tnis interface defines the EG for V/ML format 


WMLTypeRetidcTer 


The WMLTypeReaderer interface defines methods for rendering attributes provided by the 
types implementeid within this package. 


XMLTypelO 


The XMLTypelO inter&ce provides a means of formatting objects in a XML textual fashion, as 
well as parsing XML text for creating an object 



h i 12 A 
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Class Summary 




Tne AbstraccDataTest class provides a default Implemeniadon of re^r 
(Object) 


X M^nTim aA/T 7^<i f n 

^^Dstracii ypeiyieta 


Ab^tractTypeMetaData provides a partial implementation of 
TypeMetaOaca to relieve the XIS developer from explicitly implementing 
irrelevant methods. 




AreaOfUncartainty o.bjects. 


ArravListTypi^MetaData 


Arrsyij-lS w 1 ypePlQ^a wo ta w a vP* uujcv»v uiai aup^wiu 

/ova zi/i7.^rrffy£,tf/ objects. 


ArravTvpeMetaDnta 


&T-ravTvmoMet*aDai-a is a tVQe obiect that suDDorU iavculan^.reflecLArrov 
objects. 


BeanTvDeM eta Data 


n ^ ^ . •« n V w ^ <e a t«/n* rt^\iOf*f fhaf cimnrtfT? //TV/1 n^fl/T.r oht^Pl^ 
Bear\TypSM6CaDa Ca is a lypc uOJC>v.l Lti<ii bu|jpuiu/uru.(ircurw wyji^^i-a. 


BooleanTypelVfetaData 


The BoolcanTypcMeiaData is a type object that supports Boolean objects. 


BoolcanTvP^^fVIetanataFactorv 


A BooleanTypeMetaOata Factory can create a 
BooleanTypeMetaData forgiven booleans. 


CachedTvneMetaData 


CachedTypeMetaOata is a type object that simply delegates all . 
T\m»V(fkfsiD9tn tailc to annthe? XvneMetaData. 


ClassiricationTy peM^ta.Bflta 


ClassificationTypeMetaOata is a type object that supports 


rnltP^-tinnuTyp^MetaData 


rn) 1 ar*t*{nn*'PvapMeta^Da.i:a IS a rvDC obiect ths^suDDOrts CoKsction 
objects. 


CoIorTvpeMetaData 


TV»» PrilrtrTunAM^tflDatft rla?« imnlem'^nts TvoeMetaData for ColOf 

objects. 


rotorTypeMetaDataZagtOIJ^ 


A n r>n*\moMA^»nAcaFact.orv can create a CoXofTyp^MacaOatia for 
a given Color object 


Conver^ionNumencXypeMetaData 


A ^^^^^^ — i #*f\nu*rtino III nil nnf* unit to fmntnfir 

A generic Numeric lypewietauaia ror convcriuis uoui whc luiu wu wiuuici. 


(ji rrgngyTy peM etflPaJta 


r^Mfv>onr«\/rLn-i(aMpf AnA^a 15 a cvne obiect that suDDorts Mutftbsr objects 
that represent Currency values. 


DateTimeTvpeMetaData 


OateTimeTypeMetaData 15 a type object that supports Date objects. 


PaterimeTvpeMetflDatflFflctorv 


A DataTimeTypeMetaDataFactocy can create 3 
DateTimeTypelietaOata for given Date objects. 


Discret&RanT^eStrinffTYpeMetajBaM 


DiscreteRangeStringTypeMetaOata is a type object that supports 
String objects with discrete ranges. 


DisplavLab«»n-ypeMetaData 


DisplayLabclTypeMetaData is a type abject that supports supports 
Display Label objects. ' 


OJCTypeMetaData 


OTGTypeMstaData is a type object that supports Dute objects. 


EnumerationTvoe 


Class to implement an enumeration in Java. 




The EnumerationTypeMetaData class is used to represent integer 
constants as strings to the user. 


FintTypeMetaData 


fontTypeMetaOata is a type object that supports font objects. 


Ha?hMapTypeMeta£a^ 


HashMapTypeMetaOaca is a type object that sMpports ja\>aMtiLHashMap 
objects. 
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HashSetTv oeM^ta Da ta 


HashSecTypeMetaOdta is a type object chat supports java,uiiLHashSe( 
objects. 


! con Sha p_eTy peMe ta I)aj a 


IconShapeTypeMe':aCa':a is a type object that supports (conShape 
objects. 




IconTypeHetaOata is a type object that supports Icon objects. 




LlnksdLls cTypeHetaOa ta is a type object that supports 
JovtLutiLLiftkedList objects. 




ListtypeMBCaOata is a type object that supports Jqya.utiLlisi objects. 


MouieMgpPr&xy 


The Kous eMapPro>{y class allows TypeEditors access to the map without 
requiring them to having any compile time knowledge of the map's. 




An implementation of the Comparator mterface that compares two objects 
umi cAvcnu j^umuer, or uiai oQui iiiipiemeni ^.^omparaoie, witn tne class of 
one assignable from the other. 


NumericTvpeMctaData 


^5uInericTypeMetaDatrf is a type object diat supports /yttm6er objects. 


iVumericTvneM eta Data Factory 


A NumericTypeMetaOata Factory can create NuaericTypeMetaOaca 
for a given class type or method return type. 


QfeiectTyp£M.eiaDaja 


ObjectTypeMecaData is a type that supports a simple Obj'ea and is 
provided to quickly add arbitrary attribute types to a Data Source Interface 

without writino mrrf cnfr*ifin KmA h^nrilfif* 


£erc^ntTyp^Mct^P;ita 


PercentTypeMetaOata is a type object that supports Number objects that 
represent Percent(%) values. 


JprpbabiUlytypeMetflPqtj^ 


grobabilityTypeMetaOata is a type object that supports Number 
objects that represent Probability values. 




RenamedTypeHet&Oata simply delegates all TypeMeUData calls to 
another TypeN4ctaData except for the getNameQ, which is overridden with 
the given value. 




ResizedTextTypeMecaData simply delegates all TypeMetaData calls to 
another TypcMetaData except for the getPixelWidthQ, which is overridden 

wtut Ulc given Value 




The Re5oucce3 class is aQtomatically generated and must be public, but it 
is intended to be used on(y by Java's internationalization support classes. 


SmartDu rationTypeM etaPata 


r\ omaTLL^uraiian 1 ypcivieiai/aca ror convenins uom one cune unit to 
another based on the maignitude of the duration value. 


StringTypetytetaPata . 


S t r ingTypeMe taOata is a type object that supports String objects. 


StringTypeMetaPataFactory 


A Strln^ypeMetaOataTactory can.create a StclngTypeMetaOaca 
for a given String object 






TypedValueXypeiWetaiiala 


TypedValueTypeMecaData is a type object that supports supports 


Ijy^MlprBfe^nCpnJgjE^CbildSugPAct 


I uc iype&ujiCorBeaiiu>oncexcc.njLXuouppojrc ciass nanuies most or me 
responsibilities of a TypeEditor and a BeanContextChild. 


TypeEditorSupport 


The TypeEditorSupport class handles most of the responsibilities of a 
TypeEditor. 


TvpetOPIugpableService 


The TypelOPXuggabieService class is responsible for loading TypelQs. 


TyperORe^i^stry 


rhe Type lORegis try class is a registry for different implemeotacions of 
Type 10 classes. 
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TvpelOSuoDort 


The TypelOSupporc provMes support Tor TypcMeUData's oeiTypelO 
methods 


TvpeMetaDatttDei&gatQr 


TypeMataDataOe legator is a type object that simply delegates all 
TypeiMetaData calls to another TypeMetaData. 


TypeMetaDataFactoryPIuggableSerytce 


T\*a, atx^f a.T^e•^r).■r^\/G^ tif-raa.tiLA Ssrvlcs CiASS is teSDOnSlbiC for 

loading TypeMetaDataFaclories. 


TvpelVfetaDataFactorvSlore 


TT*!* rl-nrA* "Pvn^K/f »»laDsrn FaCtOHCS 

I niS v^iass Siorcs • ypcivicuiii,/Quir owvui iM. 


f ypePrererences 


This class is used by TypeMetaData instances to pass information about 
preferred TypeMetaData objects. 


Ixm' 


The Types class b a holder class for the RESOURCES global variable for 
resource propernes of the comjcis. types package. 


yBlJCxijelVleLaQatii 


OKLTypeMe taOaca is a type object that supports URL objects. 



Exception Summary 


NoSuchEnumerationExceDtion 


Class CO implement an enumeration exception in Java. 


ParseFailedExceDlion 


A ParaaFaiLedSxception is thrpwn (typically by TypelO objects) when it is not 
possible to parse a given String as desired. 


TestFailed Exceotton 


The TestfaiLadException is thrown ffom the "testQ" method of a DauTest 
subclass when the value fails the test. 



Package com.xis.types Description 

This package contains classes diat provide several standard TypeMetaData classes for describmg types 
constraintsrand for rendering and editing values of diose types. 
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Figure 15 

HelloWorld.java 

/* XIS Tutorial standalone sequence example 1 data class. 7 

public class HelloWorid { 
* private float value = 1.5f; 

public String toString() { 
return "Hello Woridl"; 

public Int getlDO { 
return 5; 

} 

public float getVaiueQ { 
return value: 

) . • . • ■ . • 

// uncomment this to make "value" editable 

/* • • . 

public void setValue(float value) { 
this.value = value; 

} 

*/ ■ •. . 

} 
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Figure 16A 



1602 



TestHarness.java 

y* XIS Tutorial standalone sequence example 1 XIS interfacing. */ 
import javax.swing JFrame; 
import java-awt.eventWindowAdapten 
import java.awt.event WindowEvent; 
import com.xis.propertysheet.PropertySheetInfoBean; 
import com.xis.ui.UIBeanEvent; 
import com.xis.ui.UIBeanAdapter; 
import com.xisJeif.im.Baselnfoi\4odel; 

public class TestHarness { 

public static void main(StringQ args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(false); 

// a property sheet infobean to display HeiioWorid's attributes 
PropertySheetlnfoBean properties = new PropertySheetlnfoBeanQ; 
properties,addRawDataltem(new HelloWoridQ); 



M604 



1606 



// add listener for 'OK/ 'cancel,' or dose, which generate 'close* events a 
properties,addUIBeanListener( 
new UIBeanAdapterO { 
public void cIosed(UlBeanEvent event) { * r 1608 

System.exit(O); • . 



); 



} 



} 



// a top-level frame to hold our property sheet infobean 
JFrame frame = new JFrame("HelIoWortd Properties'');, 
//add a listener for window closing 
frame.addWindowListener( 
new WindowAdapterO { 
public void windowClosing(WindowEvent e) { ^ 
System,exit(0); 

} 

} 

): 



r 1610A- 
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Figure 16B 

Continuation of TestHarness java 



// stick the bean in the frame and display it 

frame.getContentPane().add(properties); 

frame.packO; 

frame,setVisible(true); 



>• 1610B 



} 
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Figure 17 
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Figure 18A 

HelloWorld.java 
r XIS Tutorial standaloner sequence example 2 data class. V 

import java.awt.Cclor, 

import java.beans.PropertyChangeSupport; 

import java ,beans.PropertyChangeListener; 

nv 

public class HelloWorid { 
/*{*/ 

private Int value = 1; 

private Color myCdor = Color.green; 



II this member class helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PrDpertyChangeSupport(this); 

//two aux methods to let other XIS objects pay attention to this one 
public void addPropertyChangeLlstener(PropertyChangeListenerl) { 
propertyChangeSupportaddPropertyChangeLlstener(l); 

} . - 

public void removePropertyChangeListener(PropertyChangeListener I) { 

propertyChangeSupporLremoveProperlyChangeListener(l); • 
} . 



public String toStringQ { 
return "A HelloWorid Objecf ; 

} 

public String getGreeting() { 
j return "Hello World!"; ■ 

public int getlD{){ 
return 6; 

} . • 
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Figure 18B 

Continuation of of HelloWorld.java 



publfc ^^/ Int /*}*/ getValueO { 
return value; 

} 

m 

public void setValue(int value) { 
// only update and fire property change if this is really a change 
lf(this.value!= value) { 
Int oldVaiue = this.value; 
this* value = value; 

// fire property change event to notify other XIS objects 
propertyChangeSupport.firePropertyCharlge(*Value% oldVaiue, value); J ' ' 

•} ^ . 

public Color getlWyCotorO { 
return myColon 

public void setMyColor(Color myColor) {• " . 
// only update and fire property change If this is really a change 
if (this.myColor != myColor) { 
Color oldMyColor - this.myColor; • 
thJs.myColor = myColor; 
4 II fire property change event to notify other XIS objects ") - q. 

j propertyChangeSupportfirePropertyChangefmyGolor", y \%^\ 

OldMyColor, myColor); .J 

} • 

\ } • • • 

../*}*/ 



} 
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Figure 19A 

TestHarnessjava 

/* XiS Tutorial.standalone sequence step 2 XIS interfacing. */ 

import javax.swing JFrame; 
import java.awt.event WindowAdapten 
import java.awt.eventWindowEvent; 
import com.xis.propertysheetProperty$heetlnfoBean; 
import com.xis.ui.UIBeanEvBnt; 
import com.xis^ui.UIBeanAdapter; 
import com.xis.leif.im.BaseJnfoModel; 

/*{*/ 

import jciass.chart.JCChart; 
import com,xis.plotPlotlnfoBean; 
import com.xis.plot.chartvi6ws.LeifChartView; 

public dassTestHamess{ . . 

public static void main(StringQ args) { 

// the plugin manager is only required for mpre complex applications 
// involving multiple components integrated at runtime 
BaselnfoModeLsetStartingPluglnManager{false); 

HelloWorld hello = new HeiloWoridQ; 

II a property sheet infobean to display JHelloWorid's attributes ^ * 

PropertySheetlnfoBean properties = new RropertySheetlnfoBeanQ; 
properties.addRawDataltem(hello); 

// add a listener for 'OK' or 'cancer, which generate 'close* events 
properties.addUIBeanListener( 
new UIBeanAdapterO { 
public void closed(UlBeanEvent event) { 
System.exft(0): 

} 

} 

): 
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/*f/ 



Figure 19B 

Continuation of TestHarness Java 



// a top-level frame to hold our property sheet infobean ^ 
JFrame propertySheetFrame = new JFrame(HelIoWorid Properties"): 
// add a listener for window closing 
prDpertySheetFrame.addWindowListener( 
new WindowAdapterO { 
public void windowClosing(WindowEvent e) { 
System.exit(O); 

} 

} 

); 



// stick the property Sheet bean in the frame and display it 
pnDpertySheetFrame.getContentPane().add(properties); 
propertySheetFrame.pacIcO; 
propertySheetFrame,setVisibIe(true); 

// now we create a plot Infobean to plot HelloWorld*s numeric attribute 
n\aS PlotlnfoBean plot = new PIotlnfoBeanO: 
if^^ 1^ plot.addRawDataltenns(new ObjectQ { hello }); 
p!otsetChartType(JCChart.BAR); 

//the alternatives are SCATTER_PLOT. PLOT, AREA, PIE, CANDLE. 
// and STACKING_BAR, though not all will- make sense in this example 

// a top-level frame as before to hold our property sheet infobean 
JFrame plotFrame = new JFrame{"HelloWorld Plot"); 

// stick the plot bean in and put it up 



plotFrame.getContentPanG().add(plot); 7 
plotFrame.pack(); - y 

plotFrame.sefVisible(true); 



} 
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Figure 20 
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Figure 21 

HelloWortd.java 

r XIS Tutorial standalone sequence step 3 data dass. *l 
irhport java.awt Color; 

// (property change support moved to HelloWortdTranslator) 

public class HelloWorld { 
private int value =5 1; 
private Color myCoior = Color.green; 

public String toStringO { 
return "A HelioWorid Object"; 

' } 

. public String getGreetingO { 
return "Hello Worid!"; 

} 

public int getlDO { 
return 5; 

} 

, public int getVaiueQ { 

return value; 
} • ' - 

public void setValue(int value) { 
. // all the worrying about change events is moved to the translator, 
// so we just need to do the bare change operation (unless nonXI^ 
// components need to listen to PropertyChanges) 
thts.value - value; 

}. 

m 

public Color getMyColorQ { 
return myColor; 

} 

/*{*/ 

public void setMyColor(Color myColor) { 
// just need to set the value (see setVaiueQ) 
this.myColor = myColor; 

} 

m - 
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Figure 22A 



HelloWorldTranslatorjava 

r XIS Tutorial stend^one sequence step 3 data translator dass. */ 

Import com.xis.Ieifjm.AttributeGetRequest: 
import com.xis Jeif.im J\ttributeSetRequest; 
Import com.xls.Ieif.im.Domaln; 
import com,xis,leif.im.Translaton 
import com.)ds.leifJm.FieldMetaData; 
. import com.xis.domains.display.DisplayDomain; 
Import com.xis.domains.movement.MovementDomain; 
import java.awt.Color; 

public class HelloWorldTranslator extends Translator { 

// the domains from which canned attribute metadata will be taken 
// NOTE, if an attribute appears In the methods below but its domain 
// is NOT listed here, THE ATTRIBUTE WILL BE IGNORED BY XIS 
private static final DomainQ baseDomains = new DomainO { 
DisplayDomain.getDomaInO, W!ovementDomain.getDomainO 

}; 

- 1 y/ store info about the fields, such as whether they are prefeaed or not 
01^^ I private ReldMetaDataQ fieldMetaDataArray; 

// Retum the Domains that describe the Attributes. 
S public DomainQ gefflaseDomainsO { 
^ L return baseDomains;. 

} 

// this method returns info on eadi field defined in the methods below 
/ public ReldMetaDataQ getReldMetaDataArray() { 

if (fieldMetaDataAn^y ~ null) { 

// initialize default metadata 
ReldMetaData dispname = new 

ReldMetaData(DisplayDomain,dlsplayName); 

ReldMetaData pencolor = new 

•ReldMetaData(DisplayDomain.penColor); 

FieldMetaData speed = new 

ReldMetaData(MovementDomain.speed); 

ReldMetaData course = new 

FieldMetaData(MovementDomain.course); 
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} 



Figure 22B 

Continuation of HeHoWorldTranslatorjava 

// attributes are visible ('preferred') by default; this 
// turns this off for the course attribute 

course.setVisibilfty(falseX 

// the order we put the attributes in here determines the order 
// they appear in tables or property sheets 
fieldMetaDataArray = new Fieldl\4etaDataQ { • 
dispname, speed, course, pencolor 



} 



return fieldMetaDataArray; 



iiiitiinniiiimuiiiimnuimiiimiinmmuiiiiii 

II the following methods expose attributes of the HelioWorld class; 
// instead of calling the class methods directly, XIS \wiH access 
// everything through this translator dass 
lllllllllltlllllllllllllllllllllllllllllllllinillllllllllllllllll! 

public String getDisplayName(AttributeGetRequest attributeGetRequest) { 
return ((HelloWorid) 

atbibuteGetRequest.getRawDataltemO)-toStringO; 

} 

public Color getPenCdor{AttributeGetRequest attributeGetRequest) { 
return {(HelloWorid) 

attributeGetRequestgetRawDataltBmO)-getMyColorO: 

> 

public void setPenColor(AttributeSetRequest attributeSetRequest, 
Color penColor) { 
HelloWorid helloWorid = (HelloWorid) ' 

attributeSetRequestgetRawDataltemO; 
Color oidPenCoior = heiloWorid.getMyColorO; 
if (!penColor.equals{oldPenColor)) { 
he|[oWorid.setMyColor(penColor); 
// fire property change event to notify other XIS objects 
attributeSetRequest.getBaseDataItem().fireAttributeChanged( 
DisplayDomain.penColor, oldPenColor, penColor, true); 



"A 



} 



} 



public double getSpeed(AttributsGetRequest attributeGetRequest) { 
return (double) ((HelloWorid) 

attributeGetRequestgetRawDataltem()).getValue(); 

} 




J 
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Figure 22C 

Continuation of HelloWoridTranslator.iava 

public void setSpeed(AttributeSetRequest attributeSetRequest, 

double speed) { 
HelloWorid helloWorld = (HelloWorld) 

• attributeSetRequestgetRawDataltemO; 
Double oldSpeed = new Doubte{{double)iielloWorid.getValueO); 
if (oldSpeed.doubleValueO != speed) { 
. helloWorld.setValue((int)speed); 
// fire property change event to notify other XIS objects 
attributeSetRequestgetBaseDataltem().fireAttributeChanged( 

MovementDomain.speed, oldSpeed. new Double(speed), tme); 

} 



I 



// this is a dummy attribute to demonstrate field metadata 
public double getCourse(AttributeGetRequest attributeGetReoiuest) ( 
return (double) 0; 

} 

/*{*/ 

// uncomment this to allow reflection to expose additional attributes 

// (see documentation under "Fooling Around") 

// public HelloWorldTranslator() { 

// introspectExcept(new StringQ rvalue", "myColor^); 

// } 



} 
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Figure 23A 

TestHarnessjava 

/* XIS Tutorial standalone sequence step 3 XIS interfacing. */ 

. import javax.swingJFrame; 
import java.awt.event.WindowAdapter; 
import java.awt. event WindowEvent; • 
import com.xjs.propertysheetPropertySheetlnfoBean; 
Import com.xis.ui.UIBeanEvent; 
import" com.xis . uu U i Bean Adapter; 
import com jds Jeif .im. BaselnfoModei; 
import jclass. chart JCChart; 
import com.xis.plotPlotlnfoBean; 
import com.xis.plot.chartviews,LeifChariVtew; 

import com.xis.ielf.imTranslatorRegistry; 

import com.xis.lelf.lmXeifi^ataltem; 

import com.;ds.leif.im.lnfoModel; 

import com.xis.fejf.lm.BaselnfoModel; 

import com.xis.domains.movementMovementDomain; 

import comais.domains,movennent.MovementDomainWrapper; 

import com.xis.leif j'm.LeifDataltemDelegator; 

import java.lang.refIect.lnvocationTargetExceptiop; 

import com.xis.ieif.im.UndefinedLeifAttributeException; 

/*}*/ 

public dass TestHamess { 

protected static LeifDataltem leifl-iello; 
static { 

// Register the translator for HelloWorld. In fact this is really 
// only necessary when we have not followed the standard naming 
// convention (see docs), but it can*t hurt. 
TransiatorRegistry.getTranslatorRegistry0.registerO.bjectSchema( 
HelloWorid.dass, HelloWorldTransJator.class); 

} 

/*}7 

public static void main(StringQ args) { 

// the plugin manager is only required for more complex applications 
// Involving mult/pie components integrated at runtime 
BaselnfoModel.setStarlingPluglnManager{false); 




HelloWorld hello = new HelloWorldO; 
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Figure 23B 

Continuation of TestHarnessjava 

// a property sheet infobean to display HelloWorld's attributes 
PropertySheetlnfoBean properties = new PropertySheet!nfoBean(); 
properties.addRawDataltem(heflo): 

// add a listener for 'OfC or 'cancel', which generate 'dose' events 
properties.addUIBeanUstener( 
new UIBeanAdapterO { 
public void ciosed(U IBeanEvent event) { 
System.exit(O); 

} 

} 

); 

// a top-level frame to hold our property sheet infobean 
JFrame propertySheetFrame = new JFrame("HelloWorld Properties"); 
// add a listener for window closing 
propertySheetFrame.addWindowUstener( 
new WindowAdapterO { 
public void windowCIosing(WindowEvent e) { 
System.exrt(O); 

} 

} 

); 

// stick the property Sheet bean in the frame and display it 
propertySheetFrame.getContentPane().add(properljes); • 
propertySheetFrame.pack{); 
propertySheetFrame.setVisible(true); 
// now we create a plot infobean to plot HelloWorld's numeric attribute 
PtotlnfoBean plot = new PlotlnfoBeanQ; 
plotaddRawDataltems{new ObJectQ { hello }); 
plot setChartType(JCChart BAR); 

// the alternatives are SCATTER^PLOT. PLOT, AREA, PIE. CANDLE. 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// if we do» this must consist of the attribute name preceded 
// by the fully-qualified dassname which ORIGINALLY DEFINES . 
// the attributeOescriptor - i.e.. using "HelloWortd.speed" 
// here will NOT work! If the descriptor is not defined in a 
// domain or translator dass, then it will have been defined 
// dynamically through introspection when the first instance 
// of the data item is dropped into an XIS InfbBean. 
plotsetYAxisAttribute( 
"oom.xis.domains.movemenLMovementDomain.speed"); 
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Figure 23C 

Continuation of TestHarness Java 

plotsetDynamicAcljustment(true); // so axes track value magnitude - 
plotsetBarChartAdjusting(tme); // needed in some cases for bar chart 

// a top-level frame as before to hold our plot infobean 
JFrame pfotFrame = new JFrameCHeltoWorid Plor); 

// stick the plot bean in and put it up 
plotFrame,getContentPane0.add(plot); 
plotFrame.packO; • 
plotFrame.setVisible(true): 



// create a leifDataltem version of hello and start a thread that 
//will increase it 
lelfHello = 

BaselnfoModel,getBaselnfoModel0.getLeifDataltem(hello); 
new AcceterateO; 

/*}*/ 
} // main 

}• • 
/*{*/ 

// thread to update the speed attribute on the lelfHello instance we created 
class Accelerate extends Thread { 

public AccelerateO { 
sup6r("Accelerator Thread"); 
startO; 

} ' . * 

public void njn() { 

// wrap the LeifDataltem leifHelio in a convenience wrapper that 
// gives access to attributes within that domain, If they exist 
MovementDomainWrapper helloMovementWrapper = 
MovementDomain.takeWrapperfTestHamessJeifHello); 
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Figure 23D 

Continuation of TestHamess.java 



while (true) { 

// sleep for 0.5 seconds, then,.. 

try{ 

sleep(500); 
} catch {IntenruptedException e) { 

System.exit(l); 

}' 

// '..update the speed attribute 
try{ 

h^lloMovennentWrapper.setSpeed( 

helloMovementWrapper.getSpeed()+1 ); 
} catch (UndefinedLeifAttributeExceptlon ulae) { 

// exception if this data item doesn't have this attribute ' 
System.exit(l); // usually we would do something better 
. } catch (InvocationTargetException ite) { 

II sweep up any exception tossed by tiie underlying raw Item 
System.e)dt(1 ); // usually we would do something better 

} 

}// while 
}//mnO 
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Figure 24A 
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Figure 25A 



HelloWorld.java 

/* XIS Tutorial standalone sequence step 4 data class. */ 

Import java.awtColon 

import com.xis.leif Jm^ReldMetaData; 
import com.xis,domains.dIsplay.DisplayDomain; 
import com.xis.domains.movement.MovementDomain; 
import com.xis.leifjm.Domain; 
import comJcisJeifjm.AttributeGetRequest; 
import com.xisJeif.lm JKttributeSetRequest; 
import com.xis.leif.imj^ttributeDescripton 
import java.beans.PropertyChangeSupport; 
Import java.beans.PropertyChangeUstener; 

ryi 

public class HelloWorld { 

privateint value == 1; ' ' 

private Color myColor = Color.green; 

/T/ ^ 
public static AttributeDescriptor getDisplayNameQescriptor() { 
return DfeplayDomain.displayName; 

} 

public static AttributeDescriptor getSpeedDescriptorQ { 
return MovementDomain.speed; . 

} . ' 

public static AttributeDescriptor getPenColorOescriptorO { 

return DisplayDomain.penColor; ' ^ 

} - 

/*{V // this property change support code as in step 2 /*}*/ 

// this member dass helps distribute property change events within XIS 
private PropertyChangeSupport propertyChangeSupport = 
new PrbpertyChangeSupport(this); 

// two aux methods to let other XIS objects pay attention to this one 
public voicj addPropertyChangeListener{PropertyChangeListener I) { 
propertyChangeSupporLaddPropertyChangeListener(i); • 

} 

public void removePropertyChangeListener{PropertyChangeListener I) { 
propertyChangeSupport,removePropertyChangeListener(!); 

} 
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Figure 25B 

Continuation of HelloWorldJava 

public String toStringO { 
return "A HelloWorid Object"; 

} 

public String getGreetingO { 
return "Hello Worid!*'; 

} 

public int getlDQ { 
return 5; 

} 

public int getValueO { 
return value; 

} 

/ II this function as in step 2 /*}*/ 
.public void setVaIue{int value) { 

// we only want to update and fire property change if really changes 
if (this.value != value) { 
int oidValue = this.value; 
this.value = value; 

// fire property change event to notify other XIS objects' 
propertyChangeSupporUrePropertyChangefValue", oldValue, value); 

■ } 
} ' 

// "myColor"-related methods changed to expose "penColor" instead 

public Color getPenColorQ { 
return myColon 

} . ' ' . 

public void setPenColor(Cofor penColor) { 

// we only want to update and fire property change If really changes 
if (penColor != this.myColor) { 

Color oldPenColor = this.myColon 

this.myColor = penColor; 

// fire property change event to notify other XIS objects 
propertyChangeSupport-firePropertyChangefpenColor", 

OldPenColor, penColor); 

} 

} 
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Figure 25C 

Continuation of HelloWorld Java 

// expose toStringO return under a new name 
public String getDisplayNameQ { 
return toStringO; 

} 

// expose *Value" under a new name 
public double getSpeed() { 
retum (double) getValue(); 

} 

• public void setSpeed(double speed) { 

• // we only want to update and fire property change if really changes 
Double otdSpeed = new Doubte({double)this.getValue{)); 
if (speed != oJdSpeed.doubleVaIue()) { 
setValue((int)speed); 

// fire property change event to notHy other XiS objects 
propertyChangeSupportfirePropertyChange("speed", oldSpeed, 

new Double{speed)); 

} . • • 

} 

/*}*/ 

// store info about the fields, such as whether they are preferred or not 
private static FieidMetaDataQ fieldMetaDataArray; 

// this method returns Info on each field defined In the methods below 
public static FieidMetaDataQ getFleldMetaDataAn^yO { 

if (fieldMetaDataArray == null) { 
// initialize default metadata 
ReldMetaData dispname =5 new 

FieldMetaData(DisplayDomain.displayName); . 
ReldMetaData pencolor = new I 

FieldMetaData(D!splayDomain.penColor); r "LS^Oio 

ReldMetaData speeds. new / 

Field M eta Data(M ovementDomaln. speed); 
// could customize the field metadata here 
fieldMetaDataAn-ay = new ReldMetaDataQ { 
dispname, speed, pencolor 

}: 

} 

retum fieldMetaDataArray; 

} . . • : 

/*}*/' 
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Figure 26 
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Figure 27 B 
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Figure 28 



wo 02/46916 PCTAJS0iy48418 

46/90 



^910 




(2) toads other 
PluggableSen4ces 
Into PUiglnManager 

r 

2920 



^935 

(3) Seadies component for fesourees deftwd by the PtuagableSwvica 



Peribnns aliens on resource (ound 



PtuglnManager 


(4) Add resource 
^ dass 





2930 



Application Component 



^905 



(1) Load Mlial PluggabteService 

^2915 



PluggableSefviceFinder 



4 



925 



Figure 29 



wo 02/46916 



47/90 



PCT/USOl/48418 




Figure 30 
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7 ^\MX^ 3 3 /^. 



Class ContentlnfoBean 

j ava . lano ^Obj & 

\ ' • . . 

4.. <java.awt .Compo nent ' 

1 • • 

* — l^-va ^ awtuC.Qata.ine r 

I ■ . ■ * 

** — i ava x . awing . JC o mponent 

1 • ■ * 

+ — ia vajt . swing . JPane:^ 

I . . - . ' 

com . kis . ui ,iUast ractmaaan 
• I 

SPff T ;^i3 . le i,jg . In.^obQanj . Dataltem^lnkpiBean 

-t"— 'Coa. xi? . inf obeans .eontant. ConHentlAfoBean 

All Implemented Interfaces: 

Accessible- BeanContextChndOwner BeanContextChildOwnerPelegator. BeanContextProxv ^ 
BeanContextServicesOwnerDeleg atgr- Cli p board llser, DatalterqSuik. ImageObserver. Men uContainer 
Seriaiizable. StateSavable. UlBean 



public class ContentlnfoBean 
extends Datalt emSinkUlBea f^ 
implements ClipboardUser 

The ContentlnfoBean class is a visual component that displays the contents of a raw data item. If no contents are 
available. It defaults to a split pane 'containing the JAF menu and the PropertySheet of the raw data item. The contents 
may have be multipart, and may be text, html, rich text» or an image. Multimedia sujiport will ^oon be added. 

Authon » 

Jaime Garcia, Polexis, Inc. 
See Also: 

Serialized Form 



Inner classes inherited from class javax.swing.JPane! 
JPanel. Access ibleJPa ne i 



Inner classes inherited from class java^Lswing. JComp9nent 

J( ;omportent .Access i bl eJComponent 



Inner classes inherited from class java-aw t Container 

qft,PtaiQs.y,fiec^gpjjfeAQAWTgpn<;^in^ir 
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Inner dasses inhtrittd from class iava.a-vyt. CDmpOTitnt 
Coroocnent.A€=cej5LsibleAW7CQiapqnQnt 



Field Summary 


otitic tua^4aufi!^a<U« 


R£SCXJRCS5 

localized resources for this view object 





Fields inherited from class ccni.:cis«uL AbstractlHBean 
ulbeantisfcenQr 



Fields inherited from class iavpx.3wing.JCornponent 



accesslbleContext. listenerLigt , TOOL ? IP TEXT JCSy. ui, OMDEFINSD COWOITIQN . 
WH5H_,AMCES'PQR_0F FOgagSD^^COMFONEHT, WHEH FOCUSED, ggE>i^^^F0Ca5EgjWIblf>QW 



Fieldf inherited from class javojiwt,Cfl03pPacnJ 

somaj^y;GNa5Ni. ga3isa,,ajafimsja. iiS^&ugaaEHZ/ ^jsssjbia^^m. to? ALicNMi^iT ' 



Fields inherited from interface iaYa.a>rtimage. rmageQbierver 



ftk^sn:!/ nVWESUS. HC;gHT> ep.0PETiTiE3. goMKBiTS, Humi 



Constructor Summary 



Demult constructor that creates an empty ContenctnfoBean. 





Method Summary 


. void 


B ddRawaat;aIi:em tObI ect rawDa ca I ten } 

Load the raw data item mto the ContsntfafoBean. 


void 


addRavO&talteaa {Qbi^ct C 1 rawOacalcema) 

Add the raw data items ta the array. ' , . . 


bcoia»n 


ca-oCleact 1 

Heaim true if the ContenrlflfoBean ha£ an object and It is selected 


taaaie«a 


eanCloar (CbiectM iteats) 

Return true if the specified items can be cleared 


boolean 


Return true if the ContentloroBean has an object and it is selected 


beolasn 


caitCopyfQb-jectif 1 itens) 

Return true if the specified items can be copied. 


boolean 


car.Cutf) 

Return true if the CoarentlnfoBean has an ol^ect and it is selected 


bcolean 


eanCut robiect r 1 items] 

Return true if the specified items can be cut 


"bcolean 


canPaate (} 

Return true if the Cootentlnfofican can paste new objects, false if not 


boolean 


Return true if the Con tentlnfo Bean can select t\\ objects. 
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boolean 


canSslact2^ane { i 

RjCtum tnic ifthe CQntc[itIn.loBc<tn c&n ua^sclccE sJl objects. 


.void 


clear {) 

iNotiiy L^uRicnunraoeaii vo rcniavc uic currem raw osxa iicfn wiiy ii ii is ssiectsd. 


void 


dear (Ob.i ect ( ] i tsmfi ) 
u^cBrs tiie given tierns. 


*old 


i^movts tbt currently loaded object, • 




contains tObiect ( 1 items} 

Rsn2m true if this ContemlafoBeaa contains ail the objects of the given array. 




contajLnsCQmponaot (Qorcocnent component) 

Check if thr given component is contained by this InfoBean 


void 


cppy (£AJ£l2n^ clipboard) 

Called to invoke this ContentlnfoBean's copy action, which is to copy all selscied data 
10 the Clipboard. 


void 


copY(_wJ.ipboacd dioboard. Obi ect n icems» 
Copies the given items into the Clipboard. 


. protftCttd void 


ctea teContsn^ { ) 

Method caltsd when there Is no content to display for a raw data kern. 


VQlC 


cuk(CXiDboard ciiDbo&rd) 

Cut selected itcnu 6*om the Con ten tin ro 5 can and post- them into CHphoanl 


void 


cuc(CllDbQard clipboard. Obiaccfl icaxas) 

Cut the given- items fi-om the ContentlnfoBean and past them- into the given Clipboard . 
on ly if chey occur in the ConleatLnlbB ean. 


pvocected .roneainor 


aetConiiaiAer?erContaa^(ine index) 

Get a container with the contents of the content object at the given index, or null if ihe 

content type is not supported. 




9>ft tCpn ton bx ( ) 

Fetch the currectly loaded raw data item 




q e t JATAnd 9 rooe r tvC awcoa nert t { 1 




Cer the JAFAndProperty component used by the ContentlnfoBean to display the 


• JH*^M 


CB tLaignafcAlfcgaHftnu t La if Datal t em dataZtem, hool ean ahcwCutPa3e.eZt:etas) 
Return the data item meou for a LeiSDatalteiti (usually the selected LeifDataltem). ' 




Return the RasourceBundle for this Con tent Inxo&ea.n. 




Get an array o f se lected objects. 


void 


in^oModelCbaog^ ( I . 

Messaged to indicate an InfbModel change for this infoBean or cne or mere of its 
LetfDataltems. 


beolean 


iSCreatingCo^Ceri^ ( ) 

Check whether default content creation is set 


boolMn 


isOragSnaJbladt ) 

Return true if the def^lt Drag support is envied. 




isOrovSnahled t ) 

Recum true ifthe default Drop support is enabled. 
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Check the selecied state of the concent object, if there is currently one loaded. 


boolesA 


isXrSNctifylngO 

Check whether the ContentLnfoBean is upihting based on XIS events and is noctfyir.s 
XI5 of raw data item anribute changes • 


fold 


nastatClioboard clisboArd) 

Paste'the data Objects Groni che given clipboard.- 


void 


venovaAlXHavD&hal beas | } 

Hemove all of the raw data items Uiat are currently loaded 




.cemovat^v^atalteaCObiect rawOataltem) 

RsmoYc the given ravr data item if it Is d\e currently loaded raw data item 


void 


'romavreaawDataltortis (Obi act i 1 rawOaCalLecvd ) 

Remove the raw data itexs n the array. 


void 


Set the selection state of the object to true. 


veld 


Set the selection state ofdie object to false. 


void 


setCseatjeCpntsat{boaleaa creace) 

Sec whether content should be created for objects that do not have any displayable 
content, via a MFAndPropertyComponent. 


,irOld 


setDr&g5n«bIed( boolean enabledragi 
' Set the Status of the de&ult Drag support 


void 


3etI>raat>%mereroxv(DcaaC3wner dxacrProxy) 
Set a DragOwner "proxy" for this InfoBeaa 


void 


aetDyop2aabla<i(boolaan enabXedrop) 
Set the status of the de&uU Drop support 


■mid 


SgJ».F^Qws.es:l£ox2C0jrop0wtt^r dropProxy) . 

Set a DropOwner "proxy* for this InfoBean. • ■ - ' 


* void 


se,i:5 election {boolean selected) 

Set die selection state of the conient object * 


void 


so txistiotiTying^ {boolean aotify) 

Sec whether the ContentlnfoBean should update based ]3n XIS events and should notify 
XIS of raw data item attnbate changes 



Methods Inherited from class com.xis.iciLmrobeHns. Data!temSinkLnB<an 



addoRFPQPtilator. addRavDa ta Ifceirj&aGroup. addServiee. sXOS&f 
erBflhftgaanConcextServieegQwnerCelegator. diapoae. ggtBeanContextProKv. 
qqt;BeanCon^ext;Servi?es , a£&Sz£srr££X£, qet;Ia3goMQtjeA , get>TAPPOffy-X?^tgTg» 
q.qt;Le^fPqftqXter?Hen\4, q^^^^j ?Dat;arten>Mapu, qetL6^gDat;e^Xt;^niHenu> qegH^p'^Sa?;, 
aetrOvnedBganContextChild . qatSarvice . qatSggvice. qefcSarvica. gehSba^uaBar?, getTooIBars . 
SAtUUr Ini t ia llzgflganCcn taxtReacurcaa . initlall2aBQan£!onti^xtSairvicaa. 
invalids telnfOttode;, ^^PropP^^TiaSnafrXftf** iaHandlinaCIioboafdOoe cat ions. 

ravcke Prana f rov Ider . y^v<?lcQgeyvj.c,g, setiDrapPaaceEflabled. aa.tflamX}.nqCJL j»P^flrrt<31ffSraj;XgPa r 

v^i^4atn?nn^^n<;^^*;aft»nC;>ntqn); 



Methods inherited from class com.xis.uLAbstr actUt5ean 

ad dUia e^r{I, i, ^(!enar . final i-Tq . oatShortT ltlg. q etTitle , cetUICQmoQnants . is Revive . 
isCloaed. iaCloseQK. Droceasm fleangveat . iragpve0yB^4nAt).atgp^]ir. ca^st;(?pag|;fttg, savaStarfi , 
setActlve . afifiSfiflfiiliilfi* 3at:?it:lg 



wo 02/46916 



54/90 



PCT/USOl/48418 



Metbodi inherited from claij javax^yythg JPanel 



Methods inherited from class javauwing JCoraponent 



?C^<3V8 COa & 1 eCnanqeLi5 1; e n e r , comDutgVis IblaRecfc . containa . createToolTin . di^^hi>. T^hi^ 
£4gegCQPeft;vChqnq8 > firePropertvChanca. glraProo^rtvChanaa . f IreProoecf ^hanoe 



fAgggcqperpvChanqe , rap rope rtvChanoa. f iregroo&rtvChap.Q«. f iregrooertvChar .Qe. 

f t rap rnrkArrvrh Anno ^ ; raVo hna Vi I f^r^S fs f-^ . ^ * 



"7 - "" ' ' ~ ^ " n. 1 --fT-^n ^TVH'^F^^^ f j.A.^i:;.rfc^u/^i. L.vi,tfaiicj«^ r A T 6 g rOPe CC VLJiai 

fASgPRPPfigtvCn^nq^ , r ^ f eVet;oabi.j^Chapqq, OQCActlonF orKevSteete . catAetionMao . 
q^WAffripiQnU. ag.tftliqninentY, oatAutoacrgLIs . qetBorder . oecaeunrir oetdliant Pr^^o r ^ o 
qgt;Coipr?qnqn^;<;MPh i Pg . qetCondlbionForKgyg^rak... qatDebuoGrAohlcaQptions T aetGraoh irr ^' 
aaSHaiflilS, qgttnpiit;tfap, qetlnpui;^^?, eetlna'^t^Verlfii..; , qetlnaeta . oeblr.^e^s 
qet;^iatgneCg « aaiU-Q£5iiaXi, qeT:MaximumSi;g. oatMinimugiSlzg . qetNextrocusablgCQmnonen r . 

qati/iaibleR^ct , qatWldth, aStX, cs£I, grabrocua. hasrocus: hid;? i..nnnHl.P..f»>o;!;T ^' 
IsFptgM^qVg^Bftgqt; , ^3Focxi^T:;aver3ablq , ;.lqht;wei.qht:CofnponenX, IsManaQtnoPoctjf; . 
^^>tay . tinprp3isqSQi; > ,?.sMinxfPumS;gaSee, iaOpamie. isOptiCTizedDraw^nnSnabled . iaPainc Intrr n a 

SA^"^^^^'^^^^ ' ?^^"'^9^^^^nt > P^ i fVUtpnqflU^^U / Paintrmcnediab^ly. print . orinbAlJ . 



^aaiB2£SaS£. R^ta^Children , a^;>^CQntponen<; , Piroce3 3ComponenbK,j^vKvAnr . procos:sFocv.^Prt.n.> , 
ggffCSggKeY6?>T>4j.nq. orQCeasKavevpn^. proces^MouseMotionSvenb . EUCCi*— " 



ygqj,5tepy9Vb<?^ , CdAq^;L<?0 , cegigterSCevboardAct ion. . remove AnceaborUatener , rewoveNotif v . 
XSmoyaPgPPerCYCh^nosLAgCepgg , ggmovoPropar t vChana aLt s taner . rarnoveVetQableChanpeLiabangr . 

ssfiiiflt, igaaJLnt, rogues cDefauUfPrf^^. p^que^t:fo<rqy, ^jasj&feicgvfeoasdfis^i^isi, ^gshaEi/ - 

gevAli,da<;e , scyoAljlecCTpVjlsj^felfl, seCACClQfUlap. setAlignmgnhY , satAlicnmanty . 



s^tH^.l^-wumSize , ge CH ax t rqqu^ableqompQn^n 1 1 setQpaoue. MtPrefegr^dSign . 



Methods inherited from dags iava.awt Contalner 



add, 1^ add, ada, addCqnt^Xng . CUg C€ O er> ddlUiaia* eo»nfrnninnn»nhc_ daliyerEvenb . 
doMyou-, , gindgomaoaentAt; , fi,ndConipop^ntA,t;, qetCQmponenb . aecComoonenbAr . ogtiCoataenpn tAb. 
q . Qt; , gogtponent£ount , 3-StCoiT02Q§njia* afifcLaxaUt, iaStfiJ-i, In^raltdagg . isaocaatfllOS . lavgii^ r 

Ust, locate > ^ niqirpumSize , paint^t^pirpo^^^n^;^, bref erradSigii. oginbCemt>Qn«>nf^ . 
pj . Qce-S5qoai ; A3.n^rq,v^n^ , oroca^aS venS, £SEQ2£, aaffifiva, gemoveAlL . reinovegQnliain^rT.t nftr. 



Methods inherited from ciasa java.aytComponen^ 



3cdH3,ararchvLxstener, add t nou bMe t hodLi a t ane r , addKevLiabenei^ . • addMouseLiscener . 
adtfrtOti^q^fot jonListenar , bounds . checfcXataae . checklmao e, coaleaeeSvftnb^ . contalRa . 
£. yg^tglmag j>, crga£fila42g, stl.s.ableE vents, discatehEvenb . finable , ehablegventa ■ 

qgtCMraftr . qel;PiropT3rqa(^, getront. t^etgontMe1^riefi .. geggoraQroo^tj , 
qetGrapt\lc3Conf jquratioD , qebrnputContext > qetlnputMethodRaguss ts . oetLocale . 
3S£XfiSailiiafl/ qetiLocationOnSereen. qetNajne . gg.tPacent . get Peer . qetSlze . <ietTool 



afiSXSftgJiacjS. gil££acafi. h^P4ie£v^nt;, jJSafleiledafie, inside / i^aDiaoIayable . isSnablAd r 
i^isiah&iSiatJJL* iAStlQWing, imild, -UiOaJLbiS. kevPown. JsajfflE, liat . list , list . Ueatior. . 
JLo^^Iocus, mouff^Dgwn, moasePrag. aousBSntgr. iQS21£fi££iX* raous^Mavg . mouaeUo . move . 
Dextfoquj , R a lQtMj, . po?l;gvept, pffepAyelm^qe, py^PftgeXTOagg^ prQcessComPonentEvgnr . 



prQeassHiegarchySoundaEvent. proqeaaHiggarchvEvent; . prccaaalnputMechodSvent . 



p?<?C$aat<Qupe£vgnb, remove, reraoveCompon en b Listener . gsmoveFocuaLiatengr . 
■reirigvgHj,grarchy8oundsMfff,«^^ P r . g«STnQvqHA<lff«^gghYU^^qnyff > reaovelnpubHebhodLisb^n^^. 
remoyeKev^^iatgnsc * rCT.OYg«ffWffaI>^gt;engg> ramoveMQuaeMoticnLi;«benii^. rapaint . repaint . 
CSJialOt, resist, .^g^Azfi, s ^SPou g d^ , ggSSffttn^g. aetComPonentnr i i-nt « t- i on . aetCuraor , 
p^CDgopT^rg^t, ^atLocale, 3etLocat;ion, flBtLagatlon. satHamq , ^etSize , aetSize . shov . 
Sftqw, sizfi, toStcin o. tracaferFocua 
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M2ihcds inherited from class igva.tang. Obiect 



clone, equals .. qetClaaa . haahCode . notLgy , notifvAll . wale , wait , wait; 



Methods Inherited rrom Interlace coin.xis.ut01cbQaaiUs££ 



Methods iDheriied from inter face coca.xis.ulUIBMn 



a!itigraafiytyCiUnBfli!l?.Heseg » remove Prop g re vChanc o Lis tener 



Field Detail 



RESOURCES 

public SSaClc final TytaadReaoureeBundle KSSOO&CSS 

lasalized resources for 'h\i view objeci. 



Constructor Detail 



•ContentlnfoBeaa 

De&ult coiutniGtor chst creates en empty ConlentlnfoBcan. 



Method Detail 



, gctContents 

public Ob-^BCt gatContaniL* 

Fetch !he ctirrectly loaded raw data item 
Retami: 

the ci2rrently loaded object, or null If no object is loaded 



setXISNotifying 

public void a«ttXxaHo^ifyiog (boolean noCiCy) 

Set whether the ContentinfoBean should update based on XIS events and should notiQ' XIS of raw data item 
aoribttte changes 

Psramelers: ^ 

not i f y - if tnie then notify XJS. else do not 
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. isXISNotifying 

puhlic booicen iaXISHotif ying ( ) 

Check whether dift ConientlnfoSean is u^da^g ba^ed on X[S evencs and is nctifying XIS of raw data item 
attribute changes 

Returns: , . . . ■ 

true if it is notifying XIS, else false 



removeAHJ^wDntaltema 

public void romavaXlJJLrwDatJLlhQiBfl () 

Rfiniove ail of the raw data items that are curremly. loaded 



getRM ounces 

public T YpcdH s sour g eOu f^ d i e gcmoseuxcaa ( ) 

Return the RasourceBundle ior this Content In ^oEadiu'. 
Overrides: 

<3S£^iBSSSiXS^ in class &a£Al£fiBSiia]£Uiaisas 
Returns: 

the staticaily sourced KesourceBundle. 



infoModelChanged 

public void infoModBlChan9«d n 

Messaged to indicate an (nfoModel change for this InfoBcan or one or more of its LeifDataltems. This should 

reload all currently loaded data items to pick up InfoModet changes. 

Overrides: 

infoHodelcnanceg in class DacalcamSlntfJiagan 



addRawDataltems 

public. void &d4ELa.w3ataZta3ia(gbj££t(J cawDatalteoks} 

Add the raw data items In the uray. WUI only add IT the' arrsiy has only one object and the object ia not the 
<cu«Tently loaded rawDa:aItem, 

Pararoeten: ^ . 

eaviDe ta I ceiu • ths array ofc^jeets to be added 



'addRavvDatflltem ' 

public void acUSlBvOataItAA{Qaiafi£ rawOataXtsre) ' 
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ioAd the raw data item Lilo the ContentlnfoBe&n. (f che tvw data iteui -supports the ContentDomain ai;d has ' 
content of type t^at is currently supported then it witi be displayed. Otherwise, if content creation is set tp true then 
default content will be created, using a JAP AndPrDpertyComponenc 
Overrides: 

addRawPatalte n'in class Data I tcmSLnktj 
Parameters: • . - 

rawoacaltsii- Che raw object to display . * 



createConUnt 

proteccad void eraa.boConfcaAfc { ) 

Method caiied when there is no content to display for a raw data item. The default behavior displays a - 
JAFAndPropertyComponeot of the object, but subclasses may wish to display something else instead. 



isCreatingContent 

public boolean isCreatingContetit ( ] 

Check:whether de&uil content creation is set If so then a JAFAndPropertyComponeot will be created for items 
that have no' display able contenL 
.' Returns: 

true if default content is created, ebe false 



setCreateContent 

public void sabCr«ateCaatent (boolean create) 

Set whether con teat should be created for objects that do not have any displayabte content, via a 

MFAndPTopertyCompoaeat 

Parameters; ' , 

create " if true, create content, else do not . ' ' 



removeRawD ataltems 

public void reaaoveaavOataltexaa t cbl act f 1 rawCaCaltesis} 



Remove the raw data items in the array. V/ili only remove the object that is currently loaded ifit is contained in d\e 
array 

' Parameters: 

cawtsaca Items - the array of objects to be removed 



remoYcRawDataltcm 

public void res>aveBawOataZtem<Sl2:lfi££ cawOataZten) 
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Remove the«{v9i raw dau item if it is ths currently leaded law data Item 
Overrides: 

remov ^RayOata ltfiffl in class oataltienSin lcO TBeai^ 
Paranieters: 

raupataZtan- the object to remove . 



ge tJAFAndProperty Com ponen t 

public JAF And? g one r t yCosioo n ar^^t; getJAFAndFrcpertyCoaxpoaenb ( ) 

Get the JAFAndProi^rty coreponcnt.tued by the ContentlnfoQcftn to display the gontcnts for raw data luim that 

have nctthing ebe todisphy. 

Retunu: 

the Etirrsnt JAFAndPiDpertyCompoflent being used 



getContatnerForContent 

protsetod Cori-sain*r 9AtCon^a.iAar7oxCon%an-t (-int index ) 

Get a contairsr with the contents of the content object'at the given index, or null if the content ^« is not 

supported.- Subclass the if yoa need support for a type that is not already supported. 

Parameters: 

index - the index of in the object 
Returns: 

a Container with the contents &t the given index 



getScIettedObjects • 

-public QUjBi;£!l gstSslectedObjeehsO ' • 

Ge! an array of selected objects. This will rerjm an empty array if there are no ssjected objects. If the ravr data 

item b selected it will return en array of sizs I with the raw data item inside - ' 

Returns: 

an array of sdecred objects 



.isSelccJfcti 

public boolean isSalsetiadt) • 

Check the seiecied state of As content object, iftheie Is currendy one loaded. If there is none, return f^ilse. 
Returns: 

true if there ts a.i cbjeet and it is selected ' 



selectAIl 



pubLl: roid selecCAUO 
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Set ihe selection state of the object to true. 
SpectHed by: 

selecL^lI in interface ClipboardUsa- 
Overrides: 

aeXec tAll in class Datal te ai SinJci^ig q^ja 



selectNone 

public void selectSlonaU 

Sec Che selecrion sSECeof the object to ^e. 



• setScIecHon. 

public 7oid sabsalfictxon (boolean s«lected) 

Set the selection stats'of.the content object 
Parameters: 

tha -new selection stats 



can Clear 

public boolean candear ( ) • 

Return true if the CDntentlnfoEeon has an object and it is selected 
SpecitTed by: 

caffCUay u Lnte.rEace ciipboardOaei; 
Overrides: . . ' 

£jLaCle&g Ul class pijt^^i^t^ffwgM^tqCy^a^ftq 
Returns: . * . * ' 

true if the raw data item is selected 
See Also: 



caaCIear 

public boolean canClaarf Qb^acti tl items! 

Return true if the specified Hems can be cleared, [f Oje item is not in the ContenllnfoBean return false. If diere is 
more than one item return ^Ise. 
Speeiiied by: 

eanClear in intaffiice Clioboardtlsi^r 
Orerrides: 

eanCiPar in dasa p^^^alteaSin^yTt^eg^y^ 
Parameters: 

iteiaa - &e Arrsy of items to be cut 
• Returns: 

true if <all of the items are present, otherwise &ls6. 
' .See Also: 
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canCopy 

public boolean canCopyt) 

Return crue ifthe ContentlnfoBean has an object and it b selected 
SpedHedby: . 

^ anCopv io interface ClipboardOaex ■ 
Overrides: . 

canCopv in class DatalbamSlnkPlBftan 
Returns; 

true it the raw data ttein is selected ^ . 
5ee Also: 



cahCopy 

public booleaa caACopyCS&jLSStCl Items^ 

Return true if the specified items can be copied. If the Item is not in'the ContentlnfoBean return false. I f there is 
more ^aa one item return ftlse. 
Specifled by: . 

ganCoov in interfeca CllobdardUaer ' ' 

OYerrldes: 

canCcQv in class DatalreaSlnkUIBaan 
Parameters: 

items - the Array of items to be cut 
Returns; 

OTjc if all of the Items arc present, othenvise false. 
See Also: 

SapffI^^,^)bje.ccUi. • " • . 



canCut 

public boolean cancuto 

•Return one If the ContentlnfoBean has an:obJect and it is selected 
Specified by: 

• gaaCut to interface aiftly?OiCt^tfff«Sff ' 
Overrides: 

£anciu in Class Pa<;flEfeeff^j!>nkp^39an. 

Returnsi 

true if the raw data item Is selected 
Set Also: 



canCut 



public boolean eanCut ( Obieet f | i tains ) 
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Return tnie tf the spedned items can be cut. If the itsxr. is aai in the ConceodnfoBeaji return false. tTdiere is more 

thSan one item rctUTTT fabc. . ' 

SpeciHedby: 

(UiiCui tn interface ciiHitosucrisujar 
Overrides: 

CfljQCJii in Clais DataIteinSinkUI9ean 
Parameters: 

iteaa • the AjTayof Hcrrw to be cut 
Returns: . ^ . 

true if all af the items arc preseor, othenvue false. 
See Also: 



csnPajie 

pubLLe boolesn car.?»stot) 

Return tnss if the ContentlnfoBean can paste ne^r objects. &2se if not. 
Specified by: 

aaagfta&g « tatcrfaee ^3,ipb9^y4P3 
Overrides: 

caaPaste in dass pataltCTSinkOYaaag 
Returns: 

defeult is always true jfor the Contcniir.foBian. 



canScicclAH 

public boolean eftnSeleetXlK ) 

Return true if the ContentI afoBean can select all objects. 
SpeeiOed by: , 

canSalft^cAll in interlace Clt pboardPser 
Overrides:^, 

Returns: * 

returns tnia if there is an object aod it is not jelectsd 



canSelectTCone 

public boolean canSelectNane t ) 

^ Rehirn true if the ContentlnfoBean can un-select ail objects. 
Returns: 

Fctucns true if (he caw data ttam is selecud 



dear • 

public ?oid elQar()! 
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Notify the ContentlnfoBcan to remove the current raw data item only if it is selected 
Specified by: ' • • 

clea.<r in interface Clj,3boa?<;tM?qy 
"Overrides: 

in class 0.A£^£j^i2isttJSfiSA 



clear 

public void cl«ar(Q|^ies£C) iteins} 

Clears the given itenis. These items only get deare'd if they actually occur in the ContsntlnfoBean. 
Specified b/: , ' ' ' _ • ' " 

c JLsic i» intcrfece OAflbaflBlUaRjr 
Overrides: 

giSAjC in class OaMlCsffiSlnWIB^ftfl 
■ Parameters: 

■ items - the ilems to cleared. 



.clearAll 

public void c3.e»rAll{) - * • 

. Removes the cunencly loaded objecL 

.copy . . , ♦ 

public void eopvt CIiaboacd clipboard) 

Called to invoke this ContentlafoBeaa's copy action, which is to copy all selected data to the Clipboard. 
Spedfled by: 

copy in intcrfacs cllpbeardUser 
Overrides: . • * 

popv ir» class OataltenvSlnkaTBaan 
Parameters: . 

clipboard < the Clipboard object that gets posted to. The actual Items posted are contained is a 
LeifTransferable, . • ' 



copy 

public void eoovf Clipboard clipboard, . 

Objeer f i iteais) 

Copies the given items into £hc Clipboard^ . 
•Specined by:' 

copy in interface (; ;iDbQardUser 
- Overrides: 

ipopv in ciass Ot» 3 ; b eni3 i nkc IBe aa 
Parameters: 

clipbca cd - the Clipboard object Aat sets posted'to. The Ktual ilenu posted arc contained in a 
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LctfTrensfcniblc. 

items - the amy orObjsct items to copied. 



cut • ... 

public void cutfC iiobcaard clipbo^fd) 

Cut selected items fh)mthsContentiAfDBe&n and post them into Gipbcv ' 
Specified by: . * ■ 

GU£ th interface ClioboardUser 
Overrides: 

guR in class Datal . tomSlnWIB Qar, 
Pammatsrs: ' . " 

clipboard • the Clipboard object that gets posted eb. The actual teems posted are contained m a 

LeifTFansfersble. 



cut . * • 

pubiic void eutl ClLpSoard clipboard, . 

Oblggpfi iteir^} 

Cut the given items from the ContentlnfbBean and post them into the given Clipboard only ifthey occur in the 
ContentlnfoBean. 
• - SpectHed by: , ' 

Overrides: ' . • 

cat in claas Oat;aIteciglnkU^Bean 
Parameters: - ' 

clipboard • the Clipboard object diat gets posted to. The atnual items posted are contained in a 

LeifTransferable. 

1 tenia • the anay of Object items to cut and posted. • 



paste . 

public vc'id paataf Clioboafd clipbcacd) 

Paste the data Objects &otn the givea clipboard. Tbts retrieves the cHpb<»rd contents and does a simp.b add. • 
Specified by: . * 

paate in inier&se Clinbeardaaeg 
Overrides.' 

• oa.3te in class CataltamStnteUIBean 
Parameters: 

cLipbpacd • the Clipboard thai contains the objects, 
Sec Also: * ■ . 

e-idrtaw Da t ^ 1 1 ems ( Obj ec .?;.{ U. 



' contaios 

' public final boolean contains ( 0&1 act f 1 icensl 
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Return tms if this ContetUlnfoBeati contains all the objects of the given arrsy. 
•ParareelBrs: 

items • an array of objects to locate In the Con tentinfo Bean. 
Returns: 

one If (here is oniy one objen li is contained. &ise otherwise 



con tainsCompo neat 

public boolean containaCompoaen^^ Coroaoaent componeat) 

' Check if thr given component is contained by this tnfoBean 
Parameten: 

component • the Component to check for 
Returns: 

true if it is conuined, else false 



getLeifDataltemMenu' ' • • • • . 

public JManu catLolfDa-talteaMaaa ( Leif Qafcalteai dataXtera, 

boolean s howCub Pas teX terns} 

Return the data item menu for a LeifDataltemXu^ny the selected LeifDataltem). this is used by che iheoubar to 
add menuitems from this JMenu to a Data menu if there is exactly one DataltemSelected selected. 
Overrides: 

Parameters;-. 

dacaxcem - the LeifDataltem to get die menu for 

shoucut Paste I tarns - true to allow cut,and paste items to appear, false to omit thenu 
Returns: 

the /Menu for the given LeifDataltem 



isDragEaabled 

public boolean tsDragCnabled ( ) 

Return true if the default Dre^ support is enabled. 
Overrides: 

i^pgftffSMaJLed in class g3tflj;t?n^SJLnHgS£aan 
.Returns: , 

true if drag is enabled. &lse if not, default is initialized to true. * 



sctDi^gEnablcd 

.public void aetOrag-SAahled (boolean enabledrag) 

Set the status of the default Drag support. 
Overrides: . 

s^DgaqPn^^led in class OaraltemSintolBPan 
Parameters: 
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enAbIs<lreg • tnie If de&uU drag support-should be used, false if not 



s ctD ragO>Y n e r P ra 

public void se tPr aoownerp cokv ( DraoOw na r diagProxy) 

Set a DragOwrcr "^roxy* for this InfoBean. 
Ortrrides; 

^gcpt:aqOwney=r?KY m class Pa taICft;rv3LnicOr.Beaq 
Parameters: 

•drag proxy ♦ 8 DcftgOwnsr implementation. 



UDropEqabled 

public boolean lsDrcpEnablad{) 

* Return true if die default Drop support is en&bled 
Overrides;. ' ' 

IsOropKnabiPrt Ib class DAfc;»rhamjiintn;|yfffln 
Returns: 

true if drag is eiubted, &be if not, default is iaitiaiized to true. ■ 



setDropEnabled 

public void seLD^apEBabied {boolean enablectcop) • 

Setihe status of the defisuU Drop support. 
Overrides: 

AStfiiflaEOflbifi^ in class O ataltemSinkOISean . 

• Parameters: 

enahXedrop • srue if default drsg support should be used, false if not 

' ■ « ^ 

actDropOwncrProxy 

public void ■QtPxopQ<megpgoacy ( DropCwfiei^ dropproxy) 

Set a DropOwier "proxy* for this InfoBean. 
Overrides: 

' aetProoOwnerPrpKy in class OatiaTcBmStnknX gg^nl 

• Fanuneters: ^ 

dcopProxy - a DropOwner implementatioa 
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Package corn.xis.leifim 

This package contains classes that provide the APIs for using informaiion management in applications. 
See: 

Description 



Interface Summary 


Attribute 


The Attribute class represents an attribute for a particular data type. 


AttrihuteAlias 


The A.tcributeAlia3 indicates an aiias from i..n Attributes to a Single Attribute, together 
with a precision level; the higher the precision, the better die alias. 


ArtrihuteFactorv 


The Attribuceractory class allows an implementor to return an appropriate Attribute for 
the given LeifDataltem. 


AttdffuielookuQ 


The AttributeLooicup interface is used to lookup Attribute objects for a particular data 
item. 


Ovipla^abe! 


The OispiayLabel Interface defuies methods that are needed for use widi 

DisplayLalj&lActributes. 


Domain 


This interface describes the basic fields and methods possessed by all Domains. 




The InfoModel interface is the inter&ce that is used to convert raw data items into 
LeifDatallems. 




The LeifDalaftem interface represents a simple data item. 




This class is used for observering a LeifDataltem to know when it has finished processing an 
action. 


Li/eDatafiem 


The LiteDataltem interface represents a data item. 


Prop ertv Provider 


if a PropertyProvider implementation is added to services it can be used to replace the 
standard behavior when a PropertySheetView is opened from a JAF menu or as a default 
command, .1 


RawDatttUemLtyokito 


The RawOatalteraLodkup interface is used to look up a raw data item from a unique id. 



Class Summary 


AbstracUttribute 


The AbscractAttirlbuce class represents an Attribute. 


AttributeAliasPluggableServicg 


This register AttributeAliases. 


AttrlbutePescriptor 


The AtcrlbuteOescsiptor class is used to describe an 
attribute without providing fimctionality of how to use the 
attribute. 


A ttribu teDesc rip J ^ rFac to rv 


The AttribuceOescriptotFactory class is a singleton 
class used to create or get AttributaDescript;QS5. 




AttributeFactorylnfoModelSubjej 


The AttributeFactorylnfoHodelSubsec class 
provides an InfoModel that will add the Attributes specified 
by the Attribute Factories to all LeifDataltems this 
InfoModel creates. 
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AtlribtitcCgtRegue5t 


Ths Act cibuceGet Request class U used to package all 
the necessary parameisrs for getting. die value sn attribute. 




The AttrlbuceLocUaqMest ct^bundles attributes 


• Ar{ril{o.tj» 


The Atccibutca ia a contaircr for holding attributes. 




The AttribuceSecReiTues c class is Used 33 padcage all 
(he necessary paruneters for setdng aa attribute. 


Bivej)»ta.ItefB 


The aasfiCa^calteis is the fltst tvnipper around raw data ' 
rums. 




//PENDfNC(IUC); Any method ciarked wjih "PEMDrNC" in 
the JavaDoc wUI //like^ be removed before XfS ii released, 
in Rna] form. 


. Ba3elfiro|V1odelSern'icesProvld«r 


Thje Base In CoHode 12 exvices Provider cl^ will- 
provide all die services svsilable from the BaselnfoMoHdel • 
to die given BeanComcxtServices object 




This class populates J Af Menus for generic collections. 




The OataZteaAcCiont^anager class provides some useful 
static methods for dealing widi actions en LdDaalcsms. 


0alallemActlonMai]aoef.LeimeferenceAaIonList£ner 


Tbis class Is an acctonLis^ner to be.used with 
LeifReference •Load" inenus. 






The OatalcsnKenuSet class is used by die - 
LetflAFUtitides class return essendaUy a OaUUnn 
popup menu with annotation. 




The oatalteaiKeauSer .Entry class encapsulates a 
Dataltem and ifs menu, ajid also provides soir.e 
canvsnienca methods for adding additional menu items. - 


DefaullWriipperAttribuie 


The oefaul tw capperAtcribuce dass is a generic 
attribute that is the superclass of alt debits in jeneraisd 
domain attributes. 


DisobvLahclAttribute 


The oiaplayLdbelAczribute diss is used to display 
one or more Attribute values in coRjucdon with string 
llterab specified by users. 




The DispXayLabelOaca class is used by du 
DlspIayLabftlActrlbuz» to Store a mapping cf 
LeifDalaltems to DisplayLabelTempiates. 


DtiptayLqb^lTeinnlate 


The OispIayLabelTsjipIate class is used by the 
oisplayLabal At tribute to compute and Store editing 
and rendering values for eveiy UifDatalcem that has the 
attribute. 


DoqafpMethD«| 


Abstracdy represents aOcraain Medtod. 


DoroainMelhodDejcHotor 


The DasuiinMectiQdOescclpcor class is used to describe 

a DomalnMcdtod. 




The OomalnSlethodOeseelpeocF&ctory class U a 
singleton class used to create or get 
Offma i n«et hodos ar r 1 n r o r^. 


DomainWr^pper 


This class adds methods tc LsifDatdtem dclegaior that are 
useful tn the domain wrappers. 




rneCynanicAt tribute a class is used for storing - 
dynamic attributss. 
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fleldMatiUDLata . 


attribute. 




The risldMst&Odcas cIa5S represents a collection of 
FteldMetaOau for a data item. 


InroModelDalaitem 


The lafoHodsiOatalcem allowf vievys to wrap 
LeifDataltems and add/removcAnodiiy attnbutes that will 
only affect thai view. 


InroModelSubset 


Typically when creadng an fnfoModel to oest Vfithin an 
existing InfoModel, which is done byVlewUlBcans, an 
InroModslSubsct u wed 


] nygiidWnip Rcr A tt n by,t5 


The InYaUdWra-jperAtcrifautc dass 


LeifOftteltftmComoarator 


The LeilDataltemCompanUor compares teifDataltetns by 
AttributeDsscnptor supplied by the user. 


LeirDalal^inDcre^ator 


Impierticnts the rnethodi In Le^fDatadsm in 8 wrapper so 
you don't have lo. 




The LeifDataf temSorter provides a defiauit sorting tool for 
all LEIF LetfDatalteTn objects. 




This classes is used with die LeifDataltemObssrver. 


Letflnitialization 


The Lciflnitialization class handles some standard 
intrtalization tor most XIS Applicadons. 




Tbe LelfJAFUtilLtiaa class provides some aiefiil static 
methods &r LElF^related JavaBeans Activadon Framework 
(/AF) processing. 




This class is an actionListeRcr to bo used wtth 
Lei {Reference *'Load*' menus. 


Let fReq nest 


The I»e If Request class is used to package all (he 
necessaiy parameters for requesting information for a 
LeifDatahem. 




The :.elf-Tran3actLon class is used to construct a 
transaction. 


Loeked Lef fPateltem 


The LockedLeifD&taCceta class 15 used to enable locking 
on the data item. 




The MossvodRequest class is used CO package atl the 

necessary parameters for invoidng a DomainMethod for a 
LeifDataliem. 




Mutable subclass of ^ttrrDuteOeacrlptoc. 


Oba&rverSyppQrt 


This class provides use&d support for ysing the 
LeiCDataCtemObserver. 


RequMtPao;. 


The Request Pool class is used to assist Object pooling. 


ReiODrces 


The Re^ourcea class is automatically generated and must 
ae public, but it is inicndsd to be used only by Ja-/a's 
tntemadonalization support classes. 


5eteetabteDa^a[tem 


Creates a wrapper around a LetfDataltsm for a 
SelectablelnfoModcl. 


SeJectablelnfoModd 


Manages selections for the selectable Icif data items that arc 
sontaincd wtdiin this model 




A anajor design goal for XIS was to provids the abitity to 
ntegrate existing data item classes without modi^g them. 
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TranslqiQrHcfilstry 


Provides a cenrral locsticn for mainlaining Tnnslttors, 
extended Translators and beating Domain tnethccs on dau 
ilcms. 


Un(!«rmBdAHribult 


The Undef InedAt&ribucs class represeats an uadcfined 
attributes. 






The visibii IcyA^c ributa class Is an Attr&U!s that is 
r=ady ta use for LsicDitaltem visibility. 



Exception Summary 


natiltwnNatFQunt^Exceotton • 


The Oat«Xt«nMotroundSxcaptien dus is an exceptxon that can be chnjwn 
when trying to loolc iip a data item from an id 






Signals tiiat there wu a problem with the creation or modl5catioi^ of si 
ObjectSchema. 


TraosliilorKxceotloo 


The TfanslatorEjiception clasa 


UnconKerflbleAHasExceptfon 


Indicates that the requested attribute alias could not be calculated or converted. 


UndetlnedLreirAtlnbuteErcepHon 


Indicates -that die rcqaested attribute b not appiicabte far the object. 


Undefined LellMethodEiceptton 


The UadennedLeiiM^odExcepdon class Indicates that the data hem does not 
define the method. 




UnpemovableAtidbuteErctpjron 


The UnremovableAttributeExceptioQ class indicafes an attempt to remove an 
Attribute that wzs defined by the raw data item (etdter by reflection or a 
Translator.) Only additional Attributes adderdto LetfDataltems ean be removed. 
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Interface InfoModel 

Ail Superinterfaces: 

BeanContextChiidOwner, BeanCQntexKrhiidOwnefPetegator BeanContextPrDX7 

AH Known IixipJementing Classes: 
InfoMbdelSubset 



public interface InfoModef 

extends JcAnCpDifiiLCWldQjyQecP^le^gto . • 

The InfoModel Interface is the Interface that is used to convert raw data items into LeifData^tems. The InfoModel should 
hold each of these LeifDataltems created using weak references, so that the data Items can be cleaned up when thev are no 
longer being used. //PENDlNa(RK): Any method marked with "PB^DING" in the JavaDoc-wiU likely be removed 
before LEIF is released in fmal fonn. . * • " , 



Since: 

LEIF 4,0 • 
Version: 

SRevision: 1.20 S, SDate: 2001/08/17 00:54:54 S 
Author: 

David AlmilU 



Method Summary 


void 


activa.taQneOfNSarviaatObiect service) 

//PHNDtNG(RjC): This method will probably be removed from InjPoModcll Notify the InfoModei 
that the given service is the preferred service of its type, and that tfiis particular object should be returned 
if its class is requested^ until removed or until another object of the same type is passed to a future call to' 
Ais method.' • * • 


void 




Adds 8 listener to this InfoModel so diat the listener will be informed of changes to fee InfoModel. 


void 


addOneOfKSegvice (Obi act service) 

//PEND!NG{RK): This method will probably be removed from InfoModel! Add an object as a 
service to be retrieved by a call to getServiccO (via BeanContext APIs) on any class that this object 
implements or extends. 


void 


qiearSeiection {) 

Clears die selection. 


n 


Gives a list of all the LeIfDatal terns currently in the InfoModel. 




oet2sCohtejtt{ ) 

Gets an.EZ Context that corresponds to this InfoModel so the developer can use die E2 APIs. 
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tLe ifPataltna ( long uxd) 

This will attempt lo lookup a LtifDaiadcm from an id. 




gettLeif0aeaItea(p^5ei rawDscaltea) 

This will wrap a raw Java Object with a LeifDataitem wapper so you dan use it in leif asa data 

item. 




gefc|.«ifDfijs%|j»<5(0t>'^ect rawDatalteOf boolean create) 

This wOI urap a raw Java Object with a LeifDataitem wrapper so you can use it in leif as a data 
item, , . 


Lei fDatar>^«9f 
11 


t7QtL9ift>aba£b»ns (Ob'iecc r 1 cawOatalrensl 

This convenience method will wrap aa array of raw Java Objects, with LeifDataltejn wrappers so : 
you can use them in leif as LeifDaCaitems. 




9et?arentInrol^deI {) ■ 

Provides access to Che parent InfoModel dial this InfoModel delegates to. 




qe t3cAee fcedRawQatial tens 

Gees the list of aii the currently selected items for this InfoModel 




Get the selected raw' data item, if only one. 




Gets the ViewHost diat this tnfoModel ts associated with. 


void 


remove Za£oMode>lLigfcener { Inf oMod&lLis tens y listanar) 

Removes a listener &om this InfoModel so d^at the listener will no longer be informed of changes 
to the InfoModel 


roLd 


rezacveOneOflfServlco (Object servlcs) 

//Pa^fNGCRK): Tnis mediod will probably be removed from InfoModelf Remove an object chat 
was a service to be retrieved by a call to getServiceQ (via BeanContexx APIs) orf any fflass that this 
object implements or extends. 



Methods inherited. from interface com.xis.beans.bcanconterLBeanContextCht1dOwnerDetegator 



Methods inherited from interface com>xis.beans. beancon texL B ea nContgytCh HdO wnei 
getQwnedaeanCpp,l;gx^;C?i4.^rf 



Methods inherited from interface java.bcans.beancoBtcxt.gjg.nJ 



Method Detail 



gelLcilDatalteni 

public Leli^ Dacaltgm gatLeiSDataZbaallong uld) 

throws OataIrem»otF'oundSxceociQn 

This will attempt to lookup a LeifiDaUttem from an id. If the UQD is invalid or there isnt a LeifDataitem that 

already exists with diat given (JID, a.a excsptioo will be thrown. 

Parameter?: 

uld - die unique Id for the raw data item. 
Returns: 
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the tsiroataltBoi with the given UID 



gctLeifDataltem 

public ti&jljCQa£^j;«9 9etLei£DataXtaBi{pj|2i£££ cawOatalteaiJ 

This will wrap a «w java Object with a'LeifDatritem wrapper so you can use it m leif as a data item. 
■ Parameters: 

f awoatal ten • the raw data tbac will be wrapped. {Noce: this should not d^eady be a LtifDataUznt) 
^ Returns: * . ' 

die wrapped data item. • 



gjetLeifDataltem 

public l^iSSi^JS^ ggtLeAfPabaltamf Obie efc rawOataltein. 

boolean cxeace) 

Thu will wrap a rawjiva Object with a LcifDataltcri wrapper so you can use it m Icif as a data iccm. 
Parameters; 

rawDatal tair. - the raw data that will be wrapped. (Note: this should not already be a Lei/DctalientJ 
create - if false and the Leit'Dataltein is net already in the model, dont create one and retura nul! 
. Returns: * " 

the wrapped data item, or null if "^create" is faisc and not found 



getLeiJDatalteros * 

• public Let f Data It em {) getl^jLCData Items f Object [ I rawOataltems) • * 

This convenience method will wrap an array of raw java Obiects with LeifDataltem wrappers so you can use them 
in leif as LetfDataltsms. Note that you can get an array of raw data items often from methods like getMembersQ, 
so this is a usefiit method (o have. • ' .* • • 

Parameters: 

rawOatalteiM - the raw data objects that will be wrapped. (Note- the onsets should not alrtady be 
IttfOatalivns) 
Returns: 

Che corresponding' wrapped data item array. 



^getEzContext 

public ggContaxt gatZxConbaxtO 

Gees an EZ Context that c'onresponds to this tnfoModel so the developer can use the £Z APU. 
Returns: 

the ez context for this hfo model 



ge^ingleSelectedl tern 

public 9atSlngle5«IactadI£ea(} 
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Get the seleciedrsw dats Item, If only one. Else return null. . 
Returns: 

che-selected item if there \s only one. 



gelParentlnfoModel • 

public £af3^&dsl gatr&7&atZiifoModel(} • * * . ' . * . 

Provides access to the parent rnfoModel that this infoModel delegates ta If there is no parent modei then this will 

return null. 

Returns: 

the parent InroModel 



ciearS election 

public void claara«:l«e^onO 

Ctears the selection. 



getSeUctedRawDataltems 

public Object [1 gat SBlact.«tdaatrDataI teas C > 

Ccbthclist of all the currently selected items for this InfoMotJel 
Returns: 

all of the selected data items (as raw data Items) 



actlvateOneOfNService ' . 

' ' . ' ' 

public voi<i acti-vataOneOfMSecvicQ (Qbiect service) 

//PENDING(RK): This mediod will probably be removed from InfoModcl! Notify the InfoModcl that the given 
service is the preferred service of its type, and that this particular object should be returned if lis class is requested, 
until removed or unu'l another object of the same type is passed to a future call to this method. 
Parameters: • . • 

service' the object to become the preferred service 



addOneOlNScrvice 

public void ».ddQrvaOfKStt3gvi.c^ { Object service) 

//PENDING(RK>: This method will probably be removed from InfoModel! Add an objecLas a service to be 
retrieved by a call to getServiceQ (via BeonContext APIs) on any class that this object implements or extends. 
. Parameten: 

service - the oty'ect to be retumed when requested 
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removeOneOfNService 

public void roniov«3nQOfW5«rwic« (fi^jaSC service) 

//PENDING(RK): This msthod will probably be removed fnm In&ModeU Remove an object shat was a service to 
be retrieved by a call to getServiceO (vw BeanCcnlext APIs) on any clas4 that thia object implements or cxiends.* 
Parameters: 

service - the object to be removed &om service 



getVlewHost 

public )£LsUlias£ 9etVieirao3t ( ) 

. Gets the ViewHost that this InfoModel is associatsd with. If dUs lafoModel is not associated with a View^ost (hen 

this win remm null. - ... * 

• Returns: . *■ ' - - 

the view host^that is maintaining this InfoModel. 



addlnfoModelListener 

public roid addZji£oModelLlst:Qn.Qr ( lafoNodeiJUistaner listener) 

Adds a slstener Iq this InfoModel so that the listener will be infocmed of changes to the InfoModeL 
Parameters: 

listener - the listener to add 



remoyel nfoModelLis ten er 

i 

public VQid reaovainf oModel-Lls tener t Inf oMode iLiatgnar listener! 

Removes a listener from this InfoModel so that the listener .will no longer be infcirmed of changes to the 
InfoModeL 

Parameters: * ' ' . * 

• listener - the tistener-ib remove 



dump. 

public uifPauytefnd c£uapt} 

Gives a list of all the LeifDacaltems currently in ths InfoModeL It is highly recommended to use this method only' 
if you absohitely have no other way of accomplishing the task you need to do. Please keep in mind that if you hold 
onto the LetfDataltems contained in the array returned orif you hold onto the airay itself, the items Will not be 
removed from InfoModel until you release the to. Ifyou wish co hold onto them, you should wrap them in ' 
.De&lcReference objects. 

Note: When you use the dumpQ method in combination with the addlnfoModellistener so that you can keep track 
of the same set of Lei/Daialtems as the infpMpdei you can synchronte on the liifoModel to get the dump and 
dteit tuld a taiener to receive events o/fiiture charges. 



I 
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Example: 

synchronized ( in f ©Model) ( 

LeifOataIt:eic( I dataltems - infcModel .dumpt ) ; 
infoModel.dddXnfoModelLiat:enec(this) ; 
for {int i»0; i < data rtems . length; | 
procasa XCem (da tar terns (i]j ; 

. }' 



Returns: . . ' 

Che iist of LeifDataltenu currently in the InfoMbdel. 

See Also: 

WqiakRaference 
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Package com.xis.leif.eveiat 

This package contains classes for handling events in XIS. 
See: 

Description 



Interface Summary 


InfoModelLisiener 


The inf oModaiListener is used to monitor clianges to an InfoModcL 


LeifDataltemListener 


This class is losed for listening to LeifDataltems for various events* 



Class Summary 


AttribnteChansedEvent 


An "AttributeChanged" event gets delivered whenever a data item 
changes an attribute value. 


CoatainerAddedEvent 


A "ContainerAdded" evoit gets delivered whenever a data item is 
contained as a member in a new object 


Contain erRemovedEvent 


A "ContainerRemoved" event gets delivered whenever a data item has 
been removed as a member from a oontaioiog object. 


DataltemRenlacedEvent 


The DataltemReplacedEvent class is \ised to indicate member changes 
of a containing data item. 


InloModelEvent 


The InfoModelEvent gets delivered whenever a LeiiDataltem is created 
by ifae IhfoModel; or when a LeifDataltem has been "lost" liy.tihe 
InfoModeL 


InfoModelEventSupporf 


The inf oMcdeiEventSupport Support class provides basic support for 
managing listeners on an infoModel. 


LeifDataltemAdapter 


Tne uaif Oatalt emAdapter class provides support for setting up a 
LeifDataltemListener on a data itan. 


LeifEventSupport 


Tniais a utility class for XIS developers to use when they want to fire 

event changes. 


MemberAddedEv^t 


The MemberAddedEvent class indicates that members were added to 
this data item. 


MemberEvent 


The MemberEvent class is used to indicate members changes of a 
containing data 'item. 


MemberRem 0 vedEv en t 


The MemberRemovedEvent class indicates that llie members are being 
removed from the containing data item. 


EeferenceAddedEvent 


The Reference AddedE vent class indicates tot LeifReferences were 
added to the LeifDataltem. 


ReferenceEvent 


The ReferenceEvent class indicate changes to the LeifEleferences of 
the data item. 
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ReferenceReraovedEvent 


The ReferenceRernovedEvent class indicates that LeifReferences were 
removed from the LeifDataltem. 


ReferrerAddedEvent 


The ReferrerAddedEvent class indicates that a Refetrer was added to 
the data item. 


Ref err er Rem o vedE vent 


The ReferrerRemovedEvcnt class indicates that a Refeirer was 
removed firom the data item. 



Package com.xis.leif. event Description 

This package contains classes for handling events in XIS. 
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1 laddRavvDataltem 

^ 



2:g8tt-elfDataltem 
^ 



3 : newO 



A : adrfLeifDgtaltemUstenerO 

J 



5 : intsrrogats ielAttrihutes. etc) 



Figure 36C 
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InfoB^an 




InfoMttdet 




LeitDataltem 




Figure 36D 
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Figure 37A 

TestHarnessJava 



/* XIS Tutorial standalone sequence example 5 XIS interfacing. */ 

import javax.swing JFrame; 

import java.awLeventWindowAdapter; 

import java.awt.eventWindowEvent; 

/*r/ 

import iava,awt.GridLayout; 

import java.awLToolkit; 

import java.awt.Dimension; 

import java.awLevent.ComponentAdapten 

import java,awLevenLComponentEvent; 

import javax,swing JSplitPane; 

import javax.swing JComponent; 

/*}*/ . 

import jclassxhart. JCChart; 

import comJds.leif.im.BaselnfoModel; 

import com.xis.plot.Plot!nfoBean; 

import com.xis.plot.chartviews.teifChartView; 

import com,xis.tableTablelnfoBean; 
import com.xis,tree.TreeinfoBean; 

ryi 

public class TestHamess { , 

public static void main(StringQ args) { 

//the plugin manager is only required for more complex applications 
// involving multiple components Integrated at runtime 
BaselnfoModeLsetStartingPluglnManager(fa!se); 

/*{*/ 

HelloWorld hellol = new HelloWorid("First HelloWorid object"); 
HelloWorld heIIo2 = new HelloWorld("Second HelloWorld object"); 
HelloWorid helloS =new He!loWorid("rhird HelioWorid object."); 
HelloWorid helIo4 = new HeIloWorid(Tourth HelloWorid object"); 
HelloWorid helloS = new HelloWorid("Fifth HelloWorid object"); 
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Figure 37B 

Continuation of TestHamess.java 



ObjectO helloAn-ay = new ObjectQ { hellol . hello2, helloS. hello4. 
heiloS}; 

// create table and plot infobeans to display HelloWorld objects 
TablelnfoBean table = new TablelnfoBeanQ; 

/*}*/ 

PlotlnfoBean plot = new PlotJnfoBean{); 
plotsetChartType{JCCharLBAR); 

U the alternatives are SCATTER^PLOT. PLOT, AREA, PIE, CANDLE, 
// and STACKING_BAR, though not all will make sense in this example 

// We can set the attribute for initial display on the plot; 
// see step 3 for furtfier comments. 
plot.setYAxisAttribute( 

•"com.xis.domains.movementMovementDomain.speed"); 
ptot.setDynamicAd|ustment(true); // so axes track value n^agnitude 
plot.setBarChartAdjustlng(true); // needed in some cases for bar chart 

/*{*/ . 

// a top-level frame as before to hold both plot and table side-by-side 
JFrame tablePlotFrame = new JFrame("HelloWorid(s) Table/Plor); 
// use a repaired JSplitPane (see below) to manage the two beans 
SaneJSpIitPane sptitpane = new SaneJSplitPane(table,plot 
new Dimension(table.getPreferredSize().width + 
plot.getPrefenredSi2e().wldth, 
Math.min(tabIe.getPreferredSize().height, • 
plotgetPrefen^edSizeO-width)), 

0.50); 

tablePlotFrame.getContentPane().add(splitpane); 

tablePlotFrame.packO; 

tablePlotFrame.setVislbIe(true); 

// a tree infobean to display our HelloWorid objects 
TreelnfoBean tree = new TreelnfoBean("HelIoWorid(s) Tree"); 
tree.addRawDataltems(helloArray); 

// a top-levei frame to hold our tree infobean 

JFrame treeFrame = new JFramef HelloWorld(s) Tree"); 
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Figure 37C 

Continuation of TestHamess.java 

// avoid placing the windows on top of one another if we can 
int cutoffHeight = 424; 

if (Toolkit.getDefaultToolkit0.getScreenSize().getHeight() > 
cutoffHeight +.200) { 

treeFrame.setLocation(348,cutoffHeight+7); 

} 

r/ 

// add a listener for window closing 
treeFrame.addWindowListener( 
new WindowAdapterQ { 

public void windowClosing(WindowEvent e) { 
System.exft(0); 

. * } 
} 

); . 

// stick the tree infobean in the frame and display it 

treeFrame.getContentPane().add(tree); 

treeFrame.packQ; 

treeFrame.set\/isible(taie); 

}//main 



/** 

* This class ovenides the default JSplitPane to provide a reasonable 

* resize behavior maintain the left and right panels in the same 

* proportions. 
7 

public static final class SaneJSpiitPane extends JSplitPane { 

private int lastWidth; 
private double lastDividerProp; 

public SaneJSp!itPane(JComponent leftComponent, 
JComponent rightComponent, 
. Dimension dims, double startProportion) { 
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Figure 37D 

Conttnuatlon of TestHarness Java 

super(JSplitPane.HORIZONTAL_SPLIT, • 

leftComponent, rightComponent); 
setS}ze(dims); 

// Since the JSplitPane doesnt set ttie lastDividerLocation 
// variable, nor does it provide any other easier way to maintain 
// the split proportion on resize, we must track the divider 
// location ourself. 
lastWidth = dims.width; 
lastDlviderProp = startPnaportion; 
setDiv?derLocation(startProportion); 

// this listens for resize events on the splitpane and makes sure 
// we keep same split proportions 
addComponentListener(new ComponentAdapter() { 

public void componentResjzed(ComponentEvent event) { 
setDividerLocatJon(lastDlviderProp); 
lastWidth = (int)event.getComponent(), • 
getSize{).getWidth{): 

}}): 

// only way to know if divider moved by user is to listen for 
// resize events on the components; this isnt foolproof (since 
// resizes can come from other sources) but it works well enough 
leflComponent.addComponentListener(new ComponentAdapterQ { 
public void componentResized{ComponentEvent event) { 
// we add in getDividerSizeQ / 4 to compensate for a 
// bug in JSpiitPane which doesnt take account of the 
// divider width in location-proportion conversions 
lastDlviderProp = (double)(getDividerLocation() + 
(getDivWerSizeO / 4)) / lastWidth; 

}}); 



wo 02/46916 



84/90 



PCT/USOl/48418 



Figure 38A 



Hel!oWorld(s)Tree 



f- First HelloWorld Object 
f*- E2 Second HelloWorld object 
£3 Third HeKoWoild object 
Fourth HelloWoild object 
^ £S rm HellbWorld object 



Figure 38B 
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Figure 38C 
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Interface AttributeAlias 



public interfece AttributeAlias 

The AttributeAlias indicates an alias from l.Ji Attributes to a single Attribute, together with a 
preciaon level; the higher the precision, the better the alias. The alias allows a caJler to query for one 
of the L Ji "from" attributes and get the value stored by the data item under the "to" attribute, possibly 
mediated by some conversion, such as a units transfonnation. 

If the converted or calcuated value cannot be determined, then the Attribute#getvalue ( ) method 
should throw an unconvertibiaAiiasException . This Exception is a subclass of the . 
Onde f inedLei f At t r ibut e Exc apt i on which is typically thrown by normal Attributes in this case, 
and it can provide a descriptive message indicating the source of the incompatibility. 

Tie utility of attribute aliases may be seen by considering the following example: . 

The user has performed a query from an external data source and retrieved a set of Airfields, indexed 
. by an ICAO identifier. The user now wants to get the list of Aircraft at one of the airfields. There is a 
local aircraft database with a foreign key field for Airfields, but that key is a WAC identifier, not 
ICAO. 

Assumption: The applicafion was NOT written ahead of time to know about these two databases or 
their ID types. Instead, what you have is an XIS "LeifDataitem** for the Airfield, and you have an . 
XISInfoBean for the Aircraft query form. • ' 

What you want to do is to copy (or "drop") the Airfield data item into the "WAC" field in the query, 
form. In doing this, the Form will ask the data item for its "WAC" attribute {because this is all it 
knows about). It uses the "getWAC ( } " method from some domain (say, the Alrf leXdOomain). 

The way ftis could work is that th^ would have to be an AttributeAlias defined to convert ICAO 
to WAC - or, more specifically, AviationDomciin. ICAO'to Airf ieldDomaxn.WAC. The 
AttributeAlias returns an Attribute object that knows how to transfonn ICAOs to WACs (e.g., 
by accessing a conversion table). The Attribute, in turn, has a getValue ( ) method to execute that 
. transformation and return the WAC. 

This process would be entirely transparent to the user, or even the" caller, who would just see a result 
xetumed &om the getWAC ( ) method. In cases where the conversion was not possible, the 
OnconvertibieAiiasException wouId.be thrown, possibly providing informative infonnation to 
the caller or user.- 

Finally, note that due to the way the mechaaism is set up (using resources and a piuggableServicel 
this AttributeAlias can be installed as a separate module without requiring any re*coding or re- 
compilation of the existing application. 
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Method Summary 




cretAliasedFrom ( ) 


(J 


.This indicates which AttributeDescriptors (which in turns means which 
Attributes) are required for the alias. • 


AtcributeOeflcriotor 


getAliasedTo 0 

This indicates the AttribiateDescriptcr that this AttributeAHas is for. 


Attribute 


cretAttribute ( ) 

. Get the Attribute object that is the alias Attribute. ' 




getJ?recisioaPiri.oxi'ty { ) 

This indicates the precision of the AttributeAIias. 



Method Detail 



getPrecisionPriority 

public int getPrecisionPriority { ) 

This indicates the precision of the AttributeAIias. The higher the number the better the alias. 
This number is used to determine which AttributeAIias to use when there are more than one 
alias for a given Attribute. 
Returns; 

the precision of the alias. ^ 



getAUasedFrom 

public AttributePescrlp tor f 1 getAliasedProm ( } 

This indicates which AttributeDescriptors (which in turns means which Attributes) are required 

for the alias. . 

Returns: 

the list of de^riptors required for this alias. 



getAliasedTo 

public AfctributeDescriptor getAliasedEo(> 

This indicates the AttributeDescriptor thai this AttributeAIias is for. 
Returns: 

the descriptor that this al^ is for. 



FTo,. 



wo 02/46916 



89/90 



PCT/USOl/48418 



getAttribute 

public Attribute getAttribute ( ) 

Get the Attribute object that is the alias Attribute. This attribute is responsible- for peifonning 
the translation from the aliased jBrom Attributes. The AttributeDescriptor of the Attribute 
MUST be the same AttributeDescriptor retumed by getAKasedTo. 
- Returns: 

the attribute that win do the translation. 
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